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Pi! fon ss the scene. 


aving finally seen a 
recent version of 
Text87 Plus4 working 
with Linedesign, | 
realised that the enthusiastic 
reports of the user who gave 
the demonstration were clearly 
not misplaced, Hopefully, we will 
receive a copy for review before 
too long, Text87 itself has been 
changed in several ways, having 
reached version 39, but it looks 
essentially the same as before, 
and is still much the same size. 
The addition of Linedesign to 
the Print menu is about the only 
sign of the new-found DTP 
capability, Most of the changes 
since previous versions are to 
the basic WP functions. For 
example, the editing of the Ruler 
is now interactive, making it 
more like Quill, in this respect 
This will be welcome to many 
users; you can see the effect 
new margins are having on the 
text The setting-up of founts for 
screen display, to match the 
printed ones, is now done on- 
screen, and is easier; you can 
use existing founts lists, too. 
Again, this is an area where 
users will have had difficulty with 
previous versions, and the new 
approach will be welcome, The 
Type can be changed several 
times from within the Block 
operation. 

Linedesign Itself is massive, by 
QL standards, being supplied on 
ten 35-inch DD disks. ED drives 
or a hard disk drive are desir- 
able devices! There are a variety 
of detail errors in the version | 
have seen, such as faulty char- 
acters in some founts, but the 
overall presentation of the pro- 
gram seems generally user- 
friendly, and the printed results 
are very good. The instructions 
are nicely printed, and look to 
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be well laid-out The producers 
of Linedesign have come a long 
way since they sent samples of 
their early programs to QL 
World. 

Any DTP-type program relies 
heavily on the graphical capabili- 
ties of the system it is run on, 
and QL graphics are not fast 
Linedesign is quite brisk most of 
the time, when run on a Gold 
Card-equipped QL, but there 
are times when the user will 
surely wish for the graphics 
card that Miracle Systems were 
said to have been developing 
late last year. Other things - 
notably the QXL card - got in the 
way Of this project, but it is now 
reported that Miracle have 
switched their attention to the 
card, having finished much of 
the development work on the 
QXL The QXL card may go 
some way towards speeding-up 
the 'painting’ of the screen, but 
PC graphics too are decidedly 
slow. 


QSpread 


Qspread, the Pointer 
Environment spreadsheet pro- 
gram has now got to version 
1.17, and the man who writes it - 
Oliver Fink - has written to say 
he has taken note of the points 
made in the recent review con- 
cerning the user's access to the 
program. Writers of application 
programs are sometimes 
placed in a difficult situation by 
the operating system and/or 
supervisory interface through 
which their programs communi- 
cate with the computer, and this 
iS certainly the case with 
QSpread. My sympathy is with 
the programmer. Whether or not 
there is something intrinsic to 
the “graphical user interface" 


concept which slows down the 
user's connection with the appli- 
cation program is a very debat- 
able point It is certainly true that 
the Windows GUI on the PC has 
this effect. On the other hand, it 
is also true that it takes applica- 
tion programmers some time to 
find out ways of getting GUls to 
perform, and later version of 
programs can be appreciably 
faster than the initial ones. 


Ramdisks 


Reader Michael Hussmann, 
from Hamburg, has taken me to 
task and requested that | make 
amendments to comments 
made about ramdisks in a previ- 
ous article, but further checks 
on my QLs do not suggest the 
points made earlier were wrong. 
The reference to ramdisks 
came in connection with using 
Quill, and trying to prevent it 
commandeering all the available 
free memory. One way to 
restrain Quill would appear to 
be to format a ramdisk of suffi- 
cient size to reserve all the 
memory Quill really does not 
need, before Quill is loaded, the 
idea being that you could then 
get rid of the ramdisk, freeing 
the memory for use by other 
programs, The problem as | saw 
it was that the static ramdisk 
routines, as were supplied with 
some interface boards, or as 
separate software, years ago 
would do the job simply, but the 
dynamic ramdisk routines which 
are now normal would not 

On a Gold Card-equipped QL, 
the DIR RAM1.. command will 
show a capacity of roughly the 
amount of memory currently not 
in use (use the TK2_EXT com- 
mand first). This ram drive is 
dynamic in the sense that the 


memory it is nominally occupy- 
ing will be given to programs, as 
they require it, so starting Quill 
results in all the spare memory 
being taken by it (all bar 4608 
bytes, according to the PRINT 
FREE_MEM command). 
Attempting to get around this 
behaviour by specifically format- 
ting a fixed-size ramdisk, got me 
nowhere either, since reducing 
the size of this ‘drive’ to zero by 
giving the command FORMAT 
RAM1_0 after Quill had started 
left me unable to run even a 
mini-program, and the 
FREE’“MEM figure was still 
4608 bytes, The same proce- 
dure worked quite satisfactorily 
with non-Psion programs, with 
the memory reserved by the 
ramdisk becoming available to 
any programs started subse- 
quently. 


At first sight, that was the end 
of the story but, in a subsequent 
discussion with Freddy Vachha 
of Digital Precision, he suggest- 
ed making use of the NEW 
command, before and after the 
FORMAT commana, just in case 
that freed-up the memory that a 
simple FORMAT RAM1_0 had 
not It was an obvious point - 
once Freddy had reminded me 
of it - and it did the trick 
Unfortunately, it worked once, 
but nothing | did subsequently 
reproduced the same result. 
The Trump Card would be likely 
to give similar results. Rather 
than spend a {ong time trying to 
find a fool-proof way of reserv- 
ing memory this way, it should 
be more effective to use the 
commands ALLOCATION and 
DEALLOCATE (Turbo Toolkit) 
and ALCHP, RECHP and 
CLCHP (Toolkit 2), or use Simon 
Goodwin's Taskforce. 


My comments about the 
Minerva rom clearly upset TF 
Services, and some clarification is 
needed. My feeling about modifi- 
cations to QDOS is not that they 
shouldn't be attempted, but that 
existing software should be taken 
into consideration from the start 
People who delved into Qdos 
and SuperBasic years ago found 
errors, and wrote programs to 
get around the errors, The QL 
has developed a lot over the 
years, without Qdos being 
touched, as witness the excellent 
collection of hardware and soft- 
ware we have now that did not 
exist a few years ago. 

Acomplete new operating sys- 
tem, which is what Tony Tebby is 
said to have been working on for 
some time, is a different matter, 
No-one is better placed than 
Tony to know what needs doing 
oO improve upon Gdos. 
Presumably, we have seen, and 
will see, elements of the new OS 
in the Atari and QXL hardware 
QL emulator cards. It is to be 
hoped that the new system will 
be able to run all existing, major 
software and does not produce a 
crop of complaints about incom- 
patibility to vex hardware design- 
ers and software publishers alike. 

(Next week, jousting at Windsor- 
Ed) 

And now - incidentally - another 
satisfied Minerva customer. Geoff 
Wicks responded to comments 
made In this column about the 
use of the Minerva rom. He 
reports finding no significant 
compatibility problems when 
using his regular software (Psion 
PO-Four, Perfection SE, 
Professional Publisher, 
Conqueror SE, Eye-Q, FilEd) on a 
Minerva-equipped QL, but he has 
had some trouble using Front 
Page Extra and Flight Simulator. 
He has managed to “bodge" FPE, 
using a routine supplied with 
Minerva, but the same fix pro- 
duces "the most Impressive crash 
on a QL that | have yet seen." 
Digital Precision’s Lightning is in 
use on his QL most of the time. 

He did point out that he has a 
relatively-recent version of 
Minerva - 1.93 - and that he had 
had crashes when using a 
Trump Card in the same systern, 


but is happy with the behaviour 
when a Gold Card is fitted. A cou- 
ple cf his own public-domain pro- 
grams which gave trouble on a 
standard JM rom QL work fine 
with Minerva He cites the fea- 
tures of Minerva that are of most 
advantages to him as the corn- 
posing of accented characters, 
better editing with the EDIT and 
INPUT commands, and a warm 
reset which does not corrupt the 
Gold Card clock 


Readers’ Letters 


| M Gaye sent in two 35-inch 
disks, one DD and one HD, He 
could not get either of them to 
format to the full capacity, and 
asked for a second opinion on 
them. He has both DD and HD 
drives. The HD disk was no prob- 
lam - it formatted to the full capac- 
ity first-try, on both my QL and PC. 
This suggests there is a problem 
with the HD drive Gaye used to 
format it The DD disk was anoth- 
er matter, After more than ten 
attempts, on both QL and PC, it 
gave no more than the capacity 
that Gaye had obtained from it 
Various attempts to “doctor" it did 
not increase the capacity. This 
was not surprising, as a visual 
examination of the disk surface 
revealed a wear ring near to the 
disk centre, which was the area 
reported by software as being 
bad. Something had damaged 
the disk either the drive 
read/write head had scraped it 
or some dirt had got in and done 
the job. As a final check, an HD 
format was attempted in an HD 
drive, and the disk was immedi- 
ately branded as being unusable 
for this. This may not seem sur- 
prising, but it is most unusual, in 
my experience. 

One thing to bear in mind 
when using drives to format disks 
of different densities is that you 
can get odd results; for example, 
one of the tests with these two 
disks produced 720/720 sectors 
from a disk that should give 
2880/2880. If you are using a 
Gold Card, make use of the com- 
mand FLP_DENSITY X inserting 
either D, H or E (for DD, HD or ED 
density) for X, as appropriate. This 
ensures that the interface soft- 
ware knows what the disk to be 
formatted is, 


Software - Development - QL-Soft-& Hardware Distributor 
Im stillen Winkel 12 - D-4100 Duisburg 11 Germany 
Telephone & Fax: 0203 501274 : Mailbox 0203-591706 


New Games: The Oracle (by Jochen Merz) The Oracle is on ancient toctic-puzzle, where 
you do not hove to be fast but clever You have to fill different tiles into a field, but there 
are vorious rules how to do it, If you can place all the tiles you a bonus - if you obeye 
special rules you get much more points. Every game is different, you'll never be bored. 
Features: high-score table, hints for the next move etc, DM 49,90 


Minefield (by Bernhard Scheffold) Another game for the Pointer Environment. You need 
skill ond concentration to clear a minefield. Many options, configurable size, number of 
mines etc. Toolkit Il required. DM 39,90 


QD Version 5 - The first (and only) Editor using the PE. Dynamic memory allocation, no 
limit on numbers of lines, comfortable block-handling and many, many new features, e.g. 
i a menu, better search/replace, GOTO Procedure and Function, even Machine 
code label. 

New features: VS Thing Interface which makes QDS extendable and inbuilt HyperText 
HELP System! This HELP System is very easy to use, simply move the cursor over o word 
ond press HELP (Fl) and you get extensive help on the subject. With complete HELP 
(German and English) for SuperBASIC, inclusive examples! I is very easy to make 
Assembler-Help, e.g. get external definition of routines, libraries etc, with one keystrokes. 
HELP con be called recursively, which means, you can get help on previous help on 
onother help subject. You can even edit the help texts, add remarks, examples etc. DM 


125,- 

Upgrade from OD V4 DM 30,- 

All our products which contain SuperBASIC extensions will be updated so that they will 
have files which you add to your HELP System so that help is provided for additional 
Procedures/Functions! 


HyperHELP BASIC 

This product gives you instant help in SuperBASIC! The price is much lower for those who 
program in SuperBASIC only and do not require a full QD (although it is very useful). 
HyperHELP can be executed, put onto HOTKEY or woken from a Button, It displays the full 
set of SuperBASIC procedurs, functions and keywords currently existing in your machine, 
plus additional help on operators, identifiers etc. Simply click on the word you get the full 
description, use of all parameters plus examples. FORGET ABOUT YOUR MANUALS for 
parameter description! You get complete help on SuperBASIC, in German and English. The 
help files can be updated with “ editor, Quill, Text87 so that you can update and add 
remarks whenever you want, OM 


QMenu-the Menu Extension NOW IN VERSION 4! 

QMenu is a very easy to use interface with pre-defined menus (e.g. multi-column file-select, 
simple-choice boxes, select from lists, enor handling). These menus may be ‘used from 
SuperBASIC, machine code and other languages. New features: the directory name is 
(optionally) not fully listed, i.e. only the names INSIDE the subdirectory are given, allowing 
for much more files to be listed in the window. New DO AND REPORT menu, Brandnew 
feature: pre-defined directories and Extensions may be changed and configured at run- 
time! More examples, improvements here and there, which makes the menu Extension 
getting mature. DM 39,90 

Update with new manual DM 16,- 


OSpread - o new Spreadsheet program. {1 is completely mouse- and/or keyboard- 
controllable and uses, of course, the Menu Extension. Windows may be enlarged up to the 
moximum screen area, it may be split in up to three different horizontal and vertical 
sections, giving 9 independent controllable areas. Every cell may be formatted 
independently, with many options (justification, decimal point etc.) and with preview. Sum- 
and other often-used macro-functions. Maximum: 32768 cells, where, for example, 16000 
cells need about 400kBytes. Block handling and block entry is very easy, especially if you 
have a numerical pad: you select the black and enter the values one after the other. They 
are automatically place in the right order. No cursor-key-action necessary! New cellname- 
enquiry, echo-function, different rounding methods. Many addtional functions, which 
belong to today’s standord-equipment: Help, Button-function, use of the Scrap, all 
stondard file operations, calculation order row or columns etc. [V1.12] OSpread with 
comprehensive manual DM 169,- 


QDOS Reference Manual DM 89,90 
SER Mouse driver DM 40,- 
Fifi DM 49,90 

QShang DM 45,90 
LineDesign DM 249,- 
Diamonds DM 35,90 
Arcanoid DM 35,90 


OPTR DM 92,- 


DISA I 
Thing & EPROM Manager DM 61,50 
text87plus4 DM 239 


BrainSmosher DM 45,90 
Firebirds DM 35,90 

SuperGomesPack DM 90,- The lonely Joker DM 52,90 

EasyPTR Port | DM 89,- Port 2 DM 49,- Part 3 DM 49,- 


QVME - Emulator card for ATARI Mega STE DM 695,- 
Harddisk-Kit for ATARI Mega STE DM 99,- 
Medium for 44MB SyQues! changeable harddisk DM 143,- 
All sorts of Quantum SCSI-harddisks at cheap prices available, 
spare ones or readily cased (with cables, adaptor etc) for ATARIs. 


Please odd DM 13,- for ag and package (Europe) or DM 13.- for one item and 
DM 7,- for every further item (Overseas). All prices inc. 15% V.AT. (can be deducted 
for orders from non-€EC-countries). E&OE. 


Keyboard membranes ahoy! 


Sr a i ek ee 

lf your QL's keyboard isn't behaving like its old (or young) self, we have some good news. Bill Richardson 
of EEC has negotiated a whole new batch of membranes from the manufacturers, (The membrane is the 
bit that goes under the keys, and wears out) The catch is that he had had to order a good-sized batch, so 
if you think you're going to need a new keyboard membrane in the near future, now is the time to let Bill 
know. If you aren't sure, call Bill, or Tony Firshman at TFServices, and they can, no doubt, give you some 
advice. 

The new membranes cost #10 one-off, but there are discounts for quantities over 20. 

The deal included new membranes forSpectrum models Spectrum+, Spectrum+2, -3 and 128K, so if 
you know anyone who has an ailing Spectrum, tell them the news. 

EEC's Universal Disk Drives have spawned a new, cheaper version. The Economy Universal Disk 
Drives do away will all the external DIP switches, connectors etc, that are not needed, and are suitable for 
the QL, Spectrum and PCs only. 

They come in 4MB, 2MB and 1MB capacity, You do not have to buy a pair of identical-capacity drives: 
you can mix-and match to suit your needs, and save more money. The 4MB drives cost #60 each, the 
lower-capacity drives are less. 

The fully-configurable original Universal Drives are also still available. Ask Bill for advice. 


CVD WNBRlchardson & Co, (EEC), 18-21 Misbourne House, Chiltern Hill, Chalfont St Peter, SLO QUE, 
3 What no GVhairs? 


Tel, 0753 888866; TFServices, 12 Bouverle Place, London W2 1RB, Tel. 071 724 9053, 
Bill Richardson reports from the QL meeting held by 
IQLR at Newport, Rhode Island, USA on 5th June! 
Business was good, says Bill. His photos show 
Tony Firshman of TF Services "closetted" with his QL 
set-up in the toilet of the Motel where the UK party stayed, 
getting ready for the latest Minerva demonstrations at the 
show. We've heard of putting the QL on a pedestal, but 
this just goes to show that you can take your favourite 


computer anywhere! Let's hope Tony was on a roll... Feature of the meeting" was Stuart Honeyball and the 
new QXL Interface, Miracle is now IQLR's agent in the UK - a true transatlantic symbiosis. 


Pointer Programs for Mouse Mantacs 


Following last month's review of the Albin Hessler mouse interface by Bryan Davies, QL Scene draws readers’ attention to some of the range 
of programs written to run under the QJump Pointer Environment, a mouse-driven front end and management program for the QL The 
Pointer Environment itself is included with most major programs designed to run under it 

Dilwyn Jones Software (tel. 0248 354023) has an agreement with Care Electronics to market most of their QL products, Software for the 
Pointer Environment includes Qpac1, Qpac2 and Qtyp. Qpac’ is a set of Pointer Environment utilities, which include as part of their number a 
pop-up calculator, calendar, alarm, typewriter utility, digital clock and Sysmon (system monitor) utility. The Pointer Environment is included. On 
disk only, for expanded memory, Qpac2 is a full file maintenance program, allowing copy, delete, view, format, bakcup, move, execute, print, 
channels information, hotkey listing, jobs menu, Things menu, Sysdef utility, program-picking utility (to list programs currently running, for you to 
select - saves repeated Ctrl-Ciing), Qpac2 includes a tutorial program. Disk only, for expanded QL memory. 

Qtyp is a spelling and typing checker which can be used with most QL programs, including Quill. Also supplied as part of text87 Plus4, it 
comes with a 40000 English dictionary, plus French and German dictionaries, and a dictionary editor. A SuperBasic interface allows you to 
write Basic programs that use Qtyp, On disk for expanded memory only. 

These three programs are written by Tony Tebby, and Dilwyn Jones of DUC is happy to give advice on request 

Jochen Merz Software (010 49 203501274, Germany) has a long list of programs using the Pointer Environment Merz products usually 
come with the Extended Environment, including the latest Pointer Interface, window manager, Hotkey System Il and standard CONFIG. QD and 
QSpread have a menu-driven CONFIG. The minimum requirement is usually a Qdos machine (QL or Atari ST/QL emulator), one disk drive and 
ram expansion. Mast programs are Minerva-compatible, but the Thor remains a mystery. 

Merz’s roster has on it QD, the Pointer Environment text editor, Spread, the PE spreadsheet with up to 32768 cells; QSup system utilities - 
system defaults, translation table editor, notepad, printer panel, etc; Fifi, the menu-driven file finder, QDesign, a graphics program with virtual 
graphics on QL emulator and Minerva, up to 2880x2880 pixels, choice of screen/page standards, etc; Vecedit vector font editor for QDesign’s 
scalable fonts; DISA, the intelligent disassembler; DataDesign advanced catabase; QPTR, the programming manual for the Pointer Interface, 
with SuperBasic extensions to allow access to the facilities; EasyPTR menu-driven menu designer, and QMenu, which allows the use of the 
Menu Extension in your own Basic and machine code programs. 

Merz even do three games for the Pointer Environment Brain Smasher, QShang and The Lonely Joker. 

ff you are buying software for a mouse-driven system, check your supplier's opinion on whether the software you want will work with your 
mouse interface. With newer mice, the answer should be positive. Some people hate mice, but others become addicted. 
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Printing Sideways 


ef ee a ee ee ee ee 
DUC in action again - their new one is called Sidewriter, a sideways-printer utility which prints spread- 
sheets and text files sideways across the length of a sheet of paper. Sidewriter was partly inspired by a 
letter in QL World's readers’ column Open Channel, March and May 1993. ‘This program was planned 
| beotre those letters in the magazine’ writes Dilwyn Jones, "but they speeded up its completion” 
Sidewriter takes exported or printed Abacus spreadsheet files, or any plain text file. The program can 
be either pointer driven with a mouse, or used from the keyboard without the pointer environment 
installed (for unexpanded QLs, for instance). It can be used with QSpread with a plain text filter or a file 
printout 
Lines printed sideways can be configured at 256 characters as supplied, or even longer lines. It offers 
a choice of 6,89, or 12 lines per inch across the paper, handles paper up to 16 inches wide, and up to 
2048 characters sideways down the paper. There are 17 fonts in two sizes, and all may be printed in 
normal or condensed width, giving a choice of four character-widths in all. 
Gridlines can be printed to guide the eye along columns of figures in large spreadsheets. 
Expanded memory is required if the pointer environment Is in use. The PE is supplied with the pack- 
age; If used without it, Sidewriter will run on an unexpanded QL 
Sidewriter costs £15 disk or microcassette, including UK postage. Add £1 for overseas postage. 
Order from Dilwyn Jones Computing, 41 Bro Emrys, Tal-y-bont, Bangor, Gwynedd LL57 3YT. Tel. 


0248 354023, 


CASH FLOW 


GROSS PROFIT 


EXPENSES 
wages 
adver tisin 
ren 
electricity 
depreciation 
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New DJC 
Catalogue 


DJC has produced the latest issue of its 
20-page catalogue, detailing a range of 
about 100 QL products, from microdrive 
cartridges to software. It includes descrip- 
tions of all items, including many brand 
new releases, as well as sections! isting 
addresses and telephone numbers for 
QL suppliers worldwide, and answering 
some commonly-asked QL questions. 
New products listed include the serial 
mouse system for the QL, Sidewriter (a 
utility for landscape printing of wide 
spreadsheets or other documents}, and a 
range of software formerly published by 
CGH Services before their closure in 
March 1993. 

What Dilwyn doesn’t say in his press 
release is that the catalogue contains 
dozens of good, low-cost programs, and 
a number of important less-low-cost ones 
as well. Don’t overlook DJC if you are 
expanding your software base. 

Dilwyn Jones Computing, 41 Bro 
Emrys, Tal-y-bont, Bangor, Gwynedd, 
LL57 SYT. Tel. 0248 354023, 
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EX-CGH ADVENTURES 


Alan Pemberton has made his popular adventure games into SQLUG-ware, 

Formerly published by CGH Services, who closed down earlier this year, the five adventures 
are on a two-disk compilation called "adventure93. Adventure Playtime, the Tower of Valagon, 
Starplod and Ye Classical-Tyoe Adventure are on Disk 1. On Disk 2 the Voyage of the Beano 
stands alone. 

Access to SQLUG is on two levels. Adventure93 can be obtained from Qubbesoft amd 
copied as public domain so long as all the accompanying documentation is included. !n addi- 
tion, users may register their SQLUGware package for a fee {in this case for £7), for which 
they receive printed manuals, a helpline service, and free upgrades when they appear, 

SQLUG (the Scottish QL Users Group) would like more people to know about their activities 
and contact them. For information or to register your SQLUGware, write to Alan Pemberton, 
SQLUG Secretary, 65 Lingerwood Road, Newtongrange, Dalkeith, Midlothian EH22 4QQ,. 


ALL FORMATS DIARY 


Corning dates for the All Formats Computer Falr are: 

J25 Jul West Midlands National Motorcycle Museum, jnction 6 of the M42; August: no 
dates listed: Sep West Midlands National Motorcycle Museum, jnction 6 of the M42; 12 Sep 
Brighton Corn Exchange, Church St, Brighton 18 Sep Leicester De Montfort Hall, Granville St, 
Leicester. 

Check with suppliers whether they will be at a particular Fair. If you have far to travel phone 
All Formats 0608 663820 to check arrangements haven't changed. 

Day tickets are £4; attendees can get up to 50 £1-off vouchers by sending an SAE to the 
organisers at: Maple Leaf, Stretton-on-Fosse, Moreton-in March, Gloucestershire GL56 
9QX. (Only one voucher per ticket} Photocopies of these vouchers are also accepted. 
Admission to the Fairs is a flat £2 between 2pm and 4pm (£1-off vouchers do not apply ai 
these times). 
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OpenChanne!l 


Guernsey calling 


| had a response from a man 
in Guernsey to the letter you 
published in the March issue. 
Over the ‘phone he said he had 
thought he was the only QL 
user in Guernsey until he read 
my letter inthe magazine. . 

After talking with him, | started 
thinking more about hte future 
of my two QLs and my two 
Psion Organisers, and totted 
up all that | have spend on them. 
My thinking was, before the con- 
versation, that the amount of 
money needed to improve my 
QL and Organisers would be 
spent more sensibly on an 
obsolescent and therefore 
cheaper 386 and a Psion series 
3. However, this would mean all ! 
had spent (and done) previously 
would be wasted. 

Now, though, if | decide to 
spend money on upgrading, | 
will improve my QL D16 with a 
Gold Card and two ED disk dri- 
ves. My QL D11 will be 
improved, one day, to be more 
like a D16 (| started on it about 
three years ago!) The 
Organisers are being improved 
with 2*256K Flash ram packs. 
And | will continue to improve in 
my use of things | have learnt a 
little about over the last seven 
years instead of having to start 
again with a new set of conun- 
drums like | had to when chang- 
ing, after eight years, from ane of 
the early American 8K PETs, 
later expanded to 32K! 

| have bought a book which | 
hope will enable me to learn 
how to communicate better 
between the QL and the 
Organiser. Perhaps | will learn 
how to use the Tandata commu- 
nications unit more effectively 
with the QL | retire, at least par- 
tially, next year, so | should have 
more time. 

Lawrence Carpenter 
Guernsey 
Channel Is. 


Bug fixes 


May | also correct an impres- 
sion? The incompatibility prob- 
lem mentioned by Tony 
Firshman in last month's Open 
Channel was referred to me by 
another user, and has since 
been confirmed. It has apparent- 
ly been cleared up, as | have not 
had any further reports. What | 
said to Tony, in the discussion 
he mentioned, was that | did not 
remember the details at that 
time (in the middle of a Quanta 
meeting}, but there was no prob- 
lem about checking it 

We have seen something of a 
new operating system in the 
Atari QL emulator, and now in 
the QXL card, and both of them 
are, to me, welcome develop- 
ments. However, if any new OS 
causes significant problems with 
existing software, it will receive 
complaints from users, and 
some complaints are likely to be 
passed to me. 

Bryan F Davies 
Kent 


| read with interest the review 
in Vol. Il No, & of QL World of 
QMaths. As | am the author of 
one of the programs on the 
QMaths disk, Q-Fract, | gave 
particular attention to this part of 
the review, and | would like to 
thank the author for bringing to 
my attention a couple of small 
problems in 10.6, both of which 
| have corrected in 1,07. 

The first problem required me 
to borrow a QL with an old 
"slow" memory expansion, as | 
have a Gold Card system. | 
could not help but agree with 
the reviewer that the old stan- 
dard directory routine was a bit 
slow, so | have rewritten it The 
new version is about five times 
faster on most systems, and so 
should be crisp enough to keep 
most users happy. 

The second problem, inexplic- 
able error messages, was more 
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awkward, as it only occurred 
with Minerva systems, and | had 
difficulty gaining access to such 
a system to do testing. The 
result was that | found that the 
fault in the Minerva, which 
sometimes does strange things 
when comparing strings. In spite 
of this, | altered my program so 
that the offending errors should 
no longer occur. 

| would like to take this oppor- 
tunity to make a plea, both to 
Minerva users and to author 
Lawrence Reeves. When a pro- 
gram does not work properly on 
systems fitted with a Minerva 
rom, | should like to know that a 
process such as the following 
takes place: 

The author of the malfunction- 
ing program checks it for bugs, 
and corrects any found, The 
Minerva programmer also 
checks his code for bugs which 
{since he is human) it may well 
contain, and if the fault lies with 
Minerva, it can be corrected in 
the Minerva source code. 
Communication may sometimes 
be called for between the pro- 
grammer and other software 
authors, and both parties should 
be willing if need be to establish 
contact 

Unfortunately, this is not what 
often happens. Almost every 
time a program misbehaves on 
a Minerva system, the assump- 
tion is that Minerva cannot be at 
fault. This is frankly unlikely as, 
brilliant though he is, Lawrence 
too must make mistakes. My 
contact with QL users and soft 
ware authors suggests that 
many (possibly most) of the 
problems are not even brought 
to Lawrence's attention, since 
users assume that Minerva can- 
not be to blame. If Minerva is to 
evolve harmoniously, this must 
change, and where a program 
misbehaves only on Minerva 
systems bath the author of the 
program and the author of 
Minerva may have work to do 

When | examined the prob- 


lems indentified by your review- 
er, | was able to correct my 
code within a few hours. 
Lawrence Reeves is certainly a 
better programmer than | am, 
but for goodness’ sake give the 
man a chancel! If a package 
won't work properly on your 
Minerva system, report the prob- 
lem in detail to your Minerva 
supplier as well as to the suppli- 
er of the other program. That 
way is the greatest likelihood 
that it will be put right wherever 
possible. 
Mark Knight 
Notting Hill 
London 


it's funny how these things 
suddenly sit up again after years 
of quiet isnt it? Is it the weather? 
There's no doubt that when 
Minerva first appeared, some 
adherents took an aggressive 
attitude towards anyone who 
denied that Minerva was the 
One True Rom. This more than 
anything else created the 
“Minerva question’, which need 
otherwise never have existed. 
Oddly, | never received a rea- 
soned defence of the position 
from any user, although we dis- 
cussed it a good deal internally, 
having both the supportive and 
the sceptical on our team. 
Eventually after some correspon- 
dence the QView team them- 
selves offered us an article on 
Minerva’s rationale and history, 
and | eagerly accepted, but it 
never came to fruition. 

In the intervening years, more 
uséfully, work has been done 
both on, Minerva and on other 
software to improve inter-rela- 
tionships. However, / think that 
Mark is basically nght and that it 
is still widely assumed that 
Minerva is either intrinsically right 
or intrinsically intractible. Neither 
of which is true if you have what 
fooks like an incompatibility 
problem, talk to both publishers. 
And fet the best man refrain 
from treating olfferences as Sins. 


Speccy Basic 


The following information 
might be of interest to some of 
your correspondents. Spectrum 
Basic is a superset of 2X80/81 
Basic. In ather words, the two 
are alike, but the Spectrum ver- 
sion contains extra commands 
for colour, sound and graphics, 
plus a hook code for paging the 
Intgerface 1 shadow rom when 
any of its routines are invoked. 
Although QL SuperBasic con- 
tains functions and procedures 
that would be familiar to 
Spectrum users, there are a 
number of differences. It was 
written from scratch, le the actu- 
al code is not derived from 
another product, the single-key 
command entry system was not 
implemented, and the file-han- 
dling commands use a totally 
different syntax. For example, in 
Spectrum Basic: 


LOAD “M*1,MYPROG® 


In SuperBasic: 


Faint cursor 


For nearly eight years, my 
trusty old QL has given me first 
class service. Problems have 
been few and have generally 
been sorted out by reference to 
my collection of QL Worlds, 
books or by harassing a com- 
puter whiz-kid friend of mine. 
Recently, however, | have come 
across something which | 
havent been able to solve and 
would be grateful for tips. 

My Microvitec Cub monitor 
has been a bit wobbly (an inter- 
nal fuse blew, which | replaced. 
Then several months later the 
sides of the image on the 
screen started to bow inwards). 
At the moment | can't afford to 
have it looked at, so | am using 
a Phillips amber screen mono- 
chrome monitor. The program | 
use, almost exclusively is The 
Editor Special Edition, and the 
problem is that, although the 
Paper and Ink colours can be 
readily set to give good contrast 
on a black-and-white screen, 
there does not seem to be any 


LOAD MDV1_MYPROG 


Tony Tebby, being the sensi- 
ble fellow that he is, decided that 
he wouldnt subject QL users to 
the vile, sadistic and brutal form 
of torture known by PO, ST and 
Amiga owners as the Command 
Line Interface, To put it another 
way, you have to communicate 
with QDOS via machine code or 
a high-level programming tan- 
guage - which is one of the rea- 
sons why SuperBasic ws con- 
structed as a distinct and sepa- 
rate entity. 

You can turn your monitor into 
a tropical fish tank by purchas- 
ing Screen Dazzler, a wonder- 
ful new product from Dilwyn 
Jones Computing. However, 
strongly advised that you do not 
pour water or fish food into your 
display, since neither material is 
QDOS- (or electricity-) compati- 
ble. 


K J Brickwood 
Stockwell 
London 


way to change the colour (or 
character) of the cursor, which 
is very faint 
| assume that the cursor in 
the program is the standard QL 
cursor, Looking at my reference 
books on Qdos by Colin Opie, 
Andrew Pennell, Jan Jones, etc. 
it is apparent that, while there 
are routines to toggle the cur- 
sor on and off, move it up and 
down and position it on the 
screen, there does not seem to 
be any way of altering the 
colour or shape of it Please put 
me out of my misery: can it be 
done or cant it? 
Gwynne Owen-Smith 
Ashford 
Kent 


Freddie Vaccha of Digital 
Precision, publishers of The 
Editor, answers: “Cursor parame- 
ters are not changeable on a 
Sinclair QL, unfortunately. For 
example, cursor colour is always 
the XOR of the underlying strip 
colour (so red gives black, white 
gives green, etuc.). There is a 
way to edit the cursor, but alas 


provide enough 


only on Minerva QLs.” (Which 
involve something of a change 
of QL culture) ‘Hermes, from the 
same stable, is eminently rec- 
ommendabie, but doesn't help 
with cursors,” 


Thanks to Dilwyn Jones of 
DJC, we have some more 
addresses which will be useful 
to Sinclair 288 users. Dilwyn 
writes: 


"To helo Jean-Yves Rouffiac 
with his dead 288, here are 
some adverts by companies 
who still support the 288, includ- 
ing the current address of the 
288 User Group. He should be 
able to find someone who can 
repair the machine for him. 

‘He may also like to know that 
there are at least two utilities for 
connecting a 288 and a QL wa 
a simple cable link. One was 
called QZ and thought it is not 
advertised now might be avail- 
able from second-hand QL 
traders, the other was written by 
Phif Borman and is to be found 
in the Quanta Library and possi- 


HA EST 
Editor’s notebook 


There’s been a bit of sniping about magazines, 
reviews and advertisers elsewhere In the OL press 
(who no doubt feel, as we do, that they must represent 
thelr readers’ views). Leaving aside any slur on the 
people who write about the QL, and the question of 
whether any “expert” on the face of this earth could 
information to compensate entirely for 
everyone else’s inexperience (in 20 years I have never 
yet found one. Computers. Origami. Car maintenance. 
Cookery. They all require some suffering for your art) 
Leaving all that aside: Whereas It's true that some pub- 
lications (like QL World) depend on some advertising, It 
Is always possible to publish a magazine without any 
advertising at all. What It Is really not possible to pub- 
lish without - by definition - Is readers, 

Are any of us - magazine, publishers, advertisers - 
really going to mess you about that much? OK, we may 
be human, but think about It! 

Tl be looking quite scon for a regular user to review 
the new DJC printing utility Sidewriter for QL World, at 
our usual rates. Do we have any volunteers? 


ble from the Z88 User Group 
too.” 

288 Eprom magazine, mem- 
bership, and Spares Service 
(members only); also deals in 
Personal Organiser printer 
paper, ram upgrades (seif-fit); 
Version 4 rom: Roy Woodward 
Z88 Users’ Club, PO Box 15, 
Belper, Cerbyshire DE56 OXE. 
Answerphone/fax 0773 828707. 
(Club enquires with SAE please) 


Club software library: lan 
Braby, Thé Software Library, 
Z88 Users Club, PO Box 210, 
Woking, Surrey GU21 12x (All 
software enquiries to that 
address, with SAE) 


Z88s and supplies 


Ranger Computers Ltd., 
Ranger House, 2 Meeting Lane, 
Duston, Northampton NN5 6JG. 
Tel. 0604 589200. 


HiTek Marketing, 72 
Longmoor Lane, Breaston, } 
Derby DE72 3BB. Tel. 0332 
873987, 
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Italy Show 


Don't forget the 5th Italian QL Meeting - organised by Ergon 
Development and the Qltaly club - in Reggio Emilia on Sunday 26 
September 1993. Early information can be obtained from Davide 
Santachiara on +89 522 70409 or Eros Forenzi on +39 342 
492323. 


QL-l10-Card For | 
Control Applications 


from Jurgen Falkenburg of JFC Computer Technik 

Following encouragement by some customers last winter we 
decided to bring out a completely new QL product the first profes- 
sional and multifunctional input/output-board for the QL, the intelli- 
gent I/O card, 

The !lO-Card is a standard expansion board for the QL system 
bus. It is free addressable inside the complete QL rom memory, and 
Gold Card compatible, There are almost no restrictions to its appli- 
cations to allow any QL to communicate with its environment in 
terms of measurements and controls. With a high-speed A/D (8-bit, 
2 microseconds) and D/A converter (8-bit, 1 microsecond) and 32 
digital input/output lines, many connections are possible, With the 
included Basic toclkit, all I/O functions may be performed comfort 
ably. 


Co-processor 


The extra add-on is the integrated 24- 
MHz 8051 co-processor. The IlO-Card I/O 
functions may be controlled from the QL 
itself (with the on-board toolkit) or from the 
co-processcr., It is controlled with a single 
further command of the QLtoolkit, and has 
lots of pre-programmed functions. With 
many applications the QL remains com- 
pletely free for system control and as a 
constantly-available user interface. You can 
even do word-processing or programming 
work, while the IlO-Card performs compli- 
cated controls. 

Five of the digital I/O lines may be used 
for special applications: two counter/timers, 
a serial interface and external co-proces- 
sor interrupt A special register is used for 
control of and command transfer to the 
co-processor from the QL The 8051 is installed with 32K rom and 
32K ram. The dual-port ram may be accessed from the QL in 
pages of 8K. In this way, amounts of data up to 32K may be trans- 
ferred easily between the processors. For special applications 8051 
programs may downloaded from the QL into the ram and called 
there. Very flexible and powerful I/O applications can be realised. 

Those who are able to program the easy-to-learn 8051 assem- 
bler may perform solutions for special applications. The QL will 
remain free for system control and constant user input After the 
straightforward testing of your 8051 code in ram, the software may 
be transferred in the free memory of the 8051 eprom. 


Applications 


The range of applications for the llIO-Card is nearly unlimited: 
scanner, sound-sampler, voltmeter, measurement of any sensor sig- 
nals such as temperature, brightness, pressure, humidity, distance, 
rotation, speed, etc, measurement amplifier, delay- and echo-gener- 
ator, digital storage oscilloscope, counter, timer, free programmable 


analogue in 


AJD-D/A 


frequency generator (up to 1MHz), free programmable square gen- 
erator (82-channel, 200kHz or 8-channel 1 MHz), logic analyser 
with up to 32K memory depth (82-channel 200kHz, 8-channe!l 1 
MHz), interfaces with up to 32 signal lines like centronics, RS232, 
IEEE-488, SCSI, 12C-bus, Midi etc, control of up to 32 relays or 8 
bipolar stepping motors, model train control, round-counter and 
speedometer for 16-lane racing car model, trafficlight control for a ~ 
little town, and so on, 

If you want to control the production line of a car manufacturer, 
for instance, no problem: beside ram expansion, floppy and hard 
disk, up to 16 liO-Cards may be plugged into a standard QL if it is 
supplied with a special bus driver and power supply. With 128 step- 
ping motors, many movements may be controlled. If this does not 
suffice, simply install a QL-network Due to the multitasking abilities 
of the QL, even the software for such an application may be devel- 
oped with modest effort 

With the circuit suggestions in the manual, individual peripherals 
(relay driver, motor driver, amplifier, etc.) can be assembled even by 
those who are not highly skilled in electronics. Ready to-use acces- 
sories will become available soon, as well as the proven peripherals 
of our A/D-product series. 


introductory price 


As comparable boards for IBM- or industrial computers in indus- 
trial versions come at industrial prices (21000 and upwards) we are 


QL-Eprom 
QL/8051 RAM 


~ ad 
BUS-connector 


8051 processor 


trying, with a presentation offer of about £160, to encourage a great 
number of users to look at modern computer control. The populari- 
ty of the first series of the llO-Card will determine the quantity and 
price of possible following series. 

As always in the past, with the |lO-Card we tried to develop an 
innovative product expanding the QL's horizons. We hope that the 
simple QL and |lIO-Card handling will give an entry into computer- 
controlled measurement and control applications to the less experi- 
enced. For specialists, the ||O-Card will fill this gap in the QL periph- 
erals product range for the first time, 


Suppliers; JFC Computer Technik, Thanweg 36, D-75236 
Ersingen. Tel. +49 7231 81058 

UK distributor; WN, Richard-son & Co, 18-21 Misbourne 
House, Chiltern Hill, Chalfont St. Peter, SL9 QUE, Tel, 0753 
888866. 


The l!0-Card will be available from July. The starting offer will be 
DM 399 (inc. VAT) all over the EC, plus postage of DM 20. 
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Perennial solutions to perennial problems. If you have any favourites, please send them in. 


Seconds out 


With reference to the Clock 
Quirk mentioned by Bryan 
Davies in Troubleshooter, 
November 1992: the QL clock 
starts at 1961 Jan 01 000000, 
and goes on until 2097 Feb 06 
06:28;15, and you can SDATE 
any time between these limits. 
Calulations are done in 
seconds, starting DATES(0), ie 
Jan 1 1961, and the limit is the 
largest number (of seconds) that 
can be stored in 32 bits. The 
way in which very large 
numbers are stored in twos- 
complemented form is 
explained on page 4 of Andrews 
Pennell's Assembly Language 
Programming on the Sinclair QL 

The “quirk” occurs after 2029 
Jan 19 03:14:07, where Date = 
2147483647 (seconds). When 
DATE reaches a higher number 
than this, the Function returns 
the number of seconds - 
2147483648, The following 
SuperBasic lines, instead of 
those given by Bryan, will show 
DATES and DATES(DATE) as the 
same up to 2090, and if you 
care to continue STEP 1 instead 
of 10, you can go up to the 
clock's limit, 2097 Feb 06 
06:28:15. After that, you get back 
to DATES(0). 


FOR 2-1970 to 2020 
‘STEP 10 
SDATE 21.1,1,1,1 
PRINT DATES, 
DATES(DATE)DATE 
END FOR Z 
" xr2147483648 
FOR y=2030 TO 2090_ 
STEP 10. 
Saye ie 


100 


3 BATESDATESIOATE 


While not many people will be 
interested in dates up to 2097, 
many historians may be 
interested in dates before 1961. | 
came up against these 
limitations of the QL clock most 
recently in writing a program 
which prints out a tabular 


100 


calendar for any year. For 
anyone interested in dates 
outside the clock’s range, | 
enclose a listing for a DOW 
FUNCTION, which retums the 
Day Of Week for any date as a 
number 0 to 6, where 0=Sunday, 
This is, of course, for our present 
(Gregorian) callendar, but it can 
easily be adapted to work for the 
Julian calendar as well. 


DEFine FuNction 

ee a. 

LOCalxzm ae 

KeQe ae 

IF year MOD 

‘A=O) leap-1 ELSE leap-0 

IF year MOD 100-0. 

IF INTivears1 OO} MOD : 

4leap-0 

ENDIF 

z-year-1601 

dif=z 

Z-Z+INTidit/1 OO} 

Ze2INT(dit/ 100) 
_Zez+INTdit/400) 
m-MONTH 
230 SELectONm 
Big tS: 

=G)1 liz-Z+GiF leapie+z+1 
) 4 72-z+6 IF leapzez+t : 

62-24 VE leapz-zt1 

“67-2 41F leapz—2+1 

~8z72+2IF leap2-2+1 

9,1 2:2-2+5\Fleapz-z+1 

~10z-z+OlF leapze2+4 

END SEtect 

zez MOD:7 

xo{x+2+day) MOD 7 

RETurn' x 
- END. DEFine dow 


110. 
120. 
130 | 


G Jackson, Whitby, N 
Yorkshire 


Long Words 


Regarding the “Clock Quirk" 
comments in Troubleshooter 
November 1992 and February 
1993, in the QL the time (in 
seconds) is stored in the clock 
port register (PC_CLOCK) 
located at address $18000 
(D98304), This register is a Long 
Word (32 bits) and the time is 
stored as an un-signed Long 
Word Integer. This will allow a 


maximum time (relative to 1961 
Jan 01:00:00:00) of 2097 Feb 
06:06:28:15, This equals (2 to 
the 32nd)-1, or 4,294,967,295 
seconds. However, different 
protions of the date/time from 
1961 Jan 01:00:00:00 to 2097 
Feb 06:06:28:15. 

The SuperBasic SDATE and 
simple DATES commands 
(without any numeric 
parameters) treat this number as 
an un=signed Long Word 
Integer of 32 bits. This will allow 
for the clock to be set using 
SDATE, or read using PRINT 
DATES, to any date/time from 
1961 Jan 01:00:00:00 to 2097 
06:06:28:15. 

The PEEK_L command treats 
the value in PC-CLOCK as a 
signed Long Word Integer. In 
this case, bits 0 to 30 indicate 
the value, and bit 31 (the MSB) 
indicates the sign, When bit 31 


is not set, the number is positive, 


and when bit 31 is set, it is 
negative. This gives a range of 
values from -2 to the 31st 
(2,147,483,648) to +(2 to the 
32nd)-1 (2,147,483,647). 
Therefore, until 2029 Jan 
19:03:14:07 PRINT 
PEEK_L(98304) will retum an 
increasing positive floating point 
value. After this time, PRINT 
PEEK_L(98403) will retum a 
diminishing negative value. 


Listing one 


ALthough PC_CLOCK may be 
read with PEEK_L, no attempt to 
alter the value of its contents 
with the POKE_L command 
should be made. This will only 
zero the contents of the register, 
Only the correct commands 
should be used to alter the 
contents of PC_CLOCK. 

The PRINT DATE command 
treats the value in PC_CLOCK 
as an un-signed 31-bit Long 
Word, It disregards bit 31 (the 
sign bit) and returns the value in 
the lower 31 bits. It will only 
respond to numbers in the 
range 0 to +(2 to the 31st -1). It 
completely disregards the sign 
bit (bit 31). Therefore after 2029 
Jan 19:03:14:07, it will start 
again from 0 (1961 Jan 
01:00:00:00). 

So, provided the time is set 
correctly, PRINT DATES will 
return the correct time until 2097 
Feb 06:06:28:15. But, PRINT 
DATES(DATE) will only retum the 
correct date up to 2029 Jan 
19:03:1 4:07. After this time, it will 
start returning the date from 
1961 Jan 19:03:1 4:07 onwards. 

The following SuperBasic 
listings illustrate the above 
points: 


P Hutley, Dewsbury, 
West Yorkshire 


OPENS: SGR51 2X240A0X0 CLO#D. 


FOR X=O07TO 10-STEP 1. 


PRINT#5:X DATES DATES PEEK. (198304), = 
PEEK .L(98304), DATRSIDATE) BATE: Teese 


| 
2 
3° SDATE 1961: 1,1, 00X 
“4 
5 


EK (8304), 


END:-FOR'X 
Listing two : 
1 OPEN#5:SGR_ 512x2400x0 
2° FOR X +0 TO10-STEP:1.: 
32. SDATE:2029.1,193,14K: 
4° PRINT#5X DATES, DATESIPE i 
PEEK L(98904) DATES PARE: ices Rene 
5°) END FOR'X ira geabin ist! 
Listing three 


on CO No — 


“END FOR: xX 


OPENESSCR. 51 2X240A0K0 
FORX-10TO2OSTEP 1 
SDATE 2097;2.6.6,28X 
PRINTHSX DATES, DATESIPEEK. \(98804), 
PEEK HOR Cae DATE 


Version 2 


1 


Alan McTavish longs for a life afloat 


INFORMATION 


Program: Fieet Tactica/ 
Command Version 2 


Supplier DUC, 47 Bro Emrys, 
Tal-Y-Bont Bangor, Gwynedd 
LL57 8YT. Tet 0248 354023, 


Prices: QL version now £39.95; 
PC version £49.95; PC/QL com- 
bined package £75.96 (serial link 
not included), 


doubt many 


QL World 
readers are 
already famil- 


iar with Fleet Tactical 
Command. For those who are 
not, | will recap briefly (| should 
point out that it is impossible to 
do justice to this program in a 
short overview). 

FTC is a realtime naval 
wargame simulator. The pro- 
gram can be used on one or 
two QLs linked via serial/net- 
work options, Each player com- 
mands a fleet of 16 assorted 
war and supply ships. Each ship 
has to be individually controlled 
by the player either being “on” it, 
or sending signals to It You can 
move from ship to ship quite 
easily. 

The scenarios set in a 
1000x1000 mile area within 
which there are ports and natur- 
al hazards. 
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Fleet Tactica 
Command — 


Notes: 


Fastings and 
Northinge are 
whsstrnted on chit 
ehart in Nautical 
Miles, ie cach 
grid square 
represenir 
100x100 miles, 


ory) 


Water, and are 
shown on iheit 
relevant contaur 


Jines, and at 
certain other 


points thes 
O 8m 


w 


Miles Kijomet:* 


S00 An 


fepresenting an 


would represent 
an actual depid 
of water of {4 
voosres 


“Gulf Stecams” 


are shown 
arrowed st the 
geceral divection 
af flaw thus: 


1,Ska — 


and are quoted 
in average knots 
af flow a 
afensured on the 
surface 


Jester are 
iMlusgrated thus. 


Bridge view 


A lot of thought has obviously 
gone into the display which is 
divided into three distinct sec- 
tions. At the top is a line of digital 
information such as echo 
sounder readouts, fuel, capability 
readouts, etc. Underneath this is 
the bridge window that allows a 
view from any angle of 180 
degrees. If any of you own the 
enemy ships are within range 
they are displayed in a wire- 
frame 3D image (QL version) 
upon an animated sea. 

Below the bridge window is 


4 508 600 
Medusa South Wesl 


the command input console, 
tactical radar display, ship's IFF 
computer, and other useful 
instrumentation. 

The makers of FTC, Di-Ren, 
have justly claimed to have 
made the program as realistic 
as possible. The ships, for 
instance, move in a manner 
consistent with their bulk and 
weight The manuals include a 
section devoted to navigation for 
which purpose charts and 
geometry sets are provided. 
Tide flows, levels and natural 
hazards have to be taken into 
account when plotting courses. 

Ships have alt sorts of com- 


partments and machinery fitted. 
The manuals contain a wealth of 
information including, for 
instance, a ship's wiring diagram, 
Machinery is of course liable to 
break down or can be dam- 
aged during an engagement 
Compartments are likely to be 
affected by flooding and fires, 
problems that all require solving. 


More thana 
game 


FTC is stuffed with details and 
is, ta the best of my knowledge, 
unique. | am not normally a 


| 
{ 
' 


computer games player, confin- 
ing that sort of activity to chess 
or card games, but FTC is 
something different One big 
problem with the program is its 
addictive nature, something is 
always happening that requires 
your attention! 

| first purchased FTC atter its 
original review by Bryan Davies 
a couple of years ago. At that 
time program development was 
continuous and a number of 
upgrades were received from 
the developers, each providing 
new features and a more fasci- 
nating game. 

Eventually version 2 became 
available. This upgrade con- 
tained several major improve- 
ments over version one. Di-ren 
obviously made a conscious 
decision to remove some of the 
frills’ and concentrate on more 
useful features, Gone, for 
instance, were the nuclear mis- 


giles, and in came a much-need- 


ed towing option. The crew 
became part of the manage- 


ment resource situation. One 
could take on crew at their 
home ports and even transfer 
crew from ship to ship while 
under why. Given the right cir- 
cumstances, survivors could be 
rescued, The command input 
parser was improved to accept 
multiple commands and abbre- 
viations. 


Improvements 


By far the greatest improve- 
ment was a general tightening 
up on the scenario. In version 1 


you had to enforce a total exclu- 


sion zone by tracking and dis- 
abling the enemy fleet This 
could be a somewhat tedious 
business. Version 2, however, 
forces opponents to use the 
same neutral ports thereby 
ensuring contact is made, Also, 
instead of being effectively 
locked out of the game for sev- 
eral hours (game time} for viola- 


tion of neutral territory, you are 
simply bombarded by shore 
batteries! 

A further major advance with 
version 2 was the introduction 
of a two-player option on one 
machine. This option is invoked 
upon command or an automatic 
timing system. 

Fleet Tactical Command | was 
also the version that would be 
compatible with other machine 
versions. 

In 1992, Di-Ren announced 
that the long-awaited PC version 
was ready to be shipped. | 
obtained this version as an 
upgrade, To have re-pro- 
grammed FTC to run on PCs is 
something of an achievement 
As with the QL, the program has 
been produced entirely in 
machine code. ! remember Di- 
Ren stating in the early days of 
FTC that machine compatible 
versions would be produced, 
and | considered it something of 
a pipe dream! Hesitatingly, | con- 
nected the QL and PC with a 


serial link lead and was amazed 
to find that the program runs 
across the two machines with 
no apparent problems. 


PC version 


The PC version of course has 
a significantly improved display. 
The ships are in-filled graphics, 
and there is also a ‘tilt’ option 
that adds to the realism, espe- 
cially in rough weather! 

Finally, FTC was never very 
cheap, and when you receive 
the package you understand 
why, As | understand it, Di-Ren 
have recently reduced the QL 
version to £39.95. And that's a 
bargain! Take my word for it! 

Here | go again. Five hours 
into the game, and I've put three 
ships aground, sunk two, have 
one under tow and (worse) 
another short of supplies. When 
will | learn? Never run out of cot 
fee ., 
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VERY BASIC 


SUPERBASIC 


In this issue, Dilwyn Jones starts SELECTing what he’d like to write ON. 


looped 


and made 
decisions 
in the last 


issue, now we shall look at the 
use of the SELect statement to 
make more decisions. 


SELECT 


SELECT is a useful little key- 
word allows us to make deci- 
sions which depend on the 
value of a variable, or a number. 
Although in most cases we 
could use IF..THEN to make 
equivalent decisions, a SELECT 
statement is often more useful 
when there is a large number of 
choices which can be made. An 
example is worth a thousand 
words here, so study listing 
one. 

It consists of three main parts. 
The beginning of the decision 
making process is marked by 
the “SELECT ON a’ statement. 
The end of it all is marked with 


Listing two 


109 INPUT'What is 
119 SELect ON age 
129 =% TO 19 

136 
146 
156 
166 
176 
180 
196 
200 
218 END SELect 
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=26 TO 29 
=36 TO 39 


PRINT' like 
=REMAINDER 


an END SELECT statement, wile 
there are various statemenis 
starting with ‘—' between them. 

The program chooses a ran- 
dom number from 1 to 3. It then 
proceeds to translate the num- 
ber into English words. The RND 
keyword simply chooses a num- 
ber at random between the lim- 
its specified in brackets after it, 
in this case a whole number 
from 1 to 5 inclusive. 


‘a’ variable 


Firstly, the SELECT ON state- 
ment specifies that decisions will 
be made based on the value of 
a variable called "a", The deci- 
sions are placed on separ ate 
lines between the SELECT ON 
statement and END SELECT 
statements. ON can actually be 
omitted, so you only have to 
type "SELECT a’, although using 
the full form is a little bit clearer 
and more meaningful. In fact, 
there is an abbre viation for the 
SELECT keyword as well - you 
only have to type the three let 
ters SEL for it to be recognised, 


your age?';age 


PRINT'A young QL user.’ 
PRINT'In your twenties.’ 


PRINT'Thirty something,’ 


the author!’ 


PRINT'Mature and experienced!’ 


Listing one 


166 CLS 

116 LET a = 
126 PRINT ‘a is '; 
13% SELect. ON a 
146 =1 
156 =): 
160 =3 
17@ =REMAINDER : 
18% END SELecf 


though | normally type it in full to 
avoid the chance of errors. 

The lines in between specify 
what action to take for each 
value which the variable takes. 
They all take the form “=num- 
ber", where number is actually a 
number here, though it can also 
be a variable if you wish, It can 
also be a list, with values sepa- 
rated by commas, or a ‘range’ 
like in the RND statement, using 
the TO separator. 


Listing three 


146 LET compliment = 
tif SEL eat ON compliment 
126 
136 
144 
156 PRINT"QL user I 
168 : PRINT"! wouldn't 
174 PRINT"Aren't you 
18¢ END SELect 


RND(1 TO 5) 


: PRINT'One' 
PRINT'Two' 
: PRINT'Three' 


PRINT'Something else.' 


The statement 


"=: PRINTOne” 

basically means “IF a-1 THEN 
PRINT’One” as we learned last 
month, meaning that when it dis- 
covers that a has a value of one, 
it prints the word One on the 
screen, A fairly trivial little appli- 
cation, but it clearly shows how 
SELECT works. 

You may have noticed that we 


RND(1 TO 5) 


: PRINT"Hello, gorgeous.” 
: PRINT"You are looking smart today.” 
: PRINT"You must be the most intelligent” 


have ever met!" 
swap owners for the world." 
a super person!" 


Listing four 


160 CLS 

116 REPeat loop] 
126 
139 
146 
156 
169 
176 
188 
199 
208 
216 
226 
236 
249 
258 END REPeat loop2 


END REPeat loop] 
SELect ON month 
=4,6,9,11 
=2 : 


END SELect 
REPeat loop2 


only test for the numbers 1,2 
and 8, whereas the random 
number could also be 4 or 5. In 
this case, we include a 
*-REMAINDER’ statement which 
executes if none of the other 
has caught the value, What this 
means is that if “a" does not 
have one of the other values 
(1,2,3), the command after 
REMAINDER is executed, In this 
case it simply prints "Something 
Else". 

We could also have written 
that statement in these ways, to 
show how the lists and ranges 
work 


“45 
or 
-4TO5 


Lists and ranges can be com- 
bined into long sequences of 
values if you wish, though at first 
this may seem confusing. A 
statement such as this is quite 
legal, though in this example it is 
clearly of little use: 


—1,23,4 TO 5,26,30 TO 40 


Variables can be used too, 
though again of little use in this 
example. Variables tend to be 
less clear than the numbers and 
are not used as often. 

100 SELECT ON a 


: no_of_days = 
no of days = 
=REMAINDER : no_of_days = 


INPUT'Month number (1-12):';month 
SELect ON month=i TO 12:EXIT loop1l 
PRINT'Oops, invalid entry!' 


39 


28 
31 


INPUT'Day nutaber:';dno 
SELect ON dno=1 TO no_of_days:EXIT loop2 
PRINT'Oops, invalid entry!' 


110 -b:/PRINTSame as b' 
120 -cPRINTSame as c’ 
130 END SELect 


PRINT is not the only com- 
mand which can be used, all QL 
commands can be used, though 
some are not very useful or 
practical, such as NEW which 
would destroy the program! 

Incidentally, if you use a 
'=REMAINDER' clause, it should 
be right at the end of the list of 
'=' statements, to prevent it 
catching values not caught by 
other '~' statements which might 
be after it. In other words, it 
should be the last ‘-' statement 
before the END SELECT. 


Action anywhere 


In all examples so far, we have 
simply put the action statements 
or commands on the same line 
as the ‘=' statement, separated 
by a colon. This does not have 
to be the case, the action state- 
ments can be anywhere before 
the next '~’ statement - an exam- 
ple of this is in listing two. 

One small matter needs to be 
pointed out and this may be diffi- 
cult to understand at this stage. 
When testing for the value of a 
variable, it actually means 


‘approximately equal to’ not 
‘exactly equal to’, to allow for 
slight inac curacies in the use of 
decimal numbers. According to 
Jan Jones, the original designer 
of SuperBasic, in her book ‘QL 
SuperBasic, The Definitive 
Handbook’ (available from 
Quanta) the test allows for small 
rounding off errors of up to the 
seventh decimal place (plus or 
minus 1E-7)}. You may be famil- 
iar with the description ‘accurate 
to 7 decimal places’ sometimes 
given to calculators. In practice, 
what it means is that "-6" might 
not catch the value 59, but it 
should be able to catch 
6,000000001 easily enough. 
This is significant where you are 
testing for the result of a calcula- 
tion, or trying to match the value 
of something like 1/3 which 
cannot be specified exactly. 

Don't forget that you can test 
for decimal numbers as well as 
whole numbers, though on origi- 
nal QL ROM versions, you can 
only use floating point variables - 
you can't use integer variables 
(which only hold whole numbers 
and have names ending with 
the % symbol). 


Range checking 


The ‘approximately equal to’ 
rule does not apply to range 
checking. If you specify 4 TO 6, 
for example, it means just that, 
exactly equal to 4, exactly equal 
to 6, or somewhere in between. 

There is also a short form or 
‘in-line’ version of the SELECT 
state ment which can all be writ- 
ten on one line of a program! In 


Listing five 


166 CLS 
11¢ LET a = RND(1 TO 3) 
126 ON a GO TO 1969,2669,3000 


136 STOP 


\ 


this the value checks and the 
SELECT statement are all on the 
same line and there is no END 
SELECT statement All parts are 
separated by a colon. You can 
include multiple statements, or 
multiple '=' clauses if you wish, 
although one is the norm. 


SELECT ON a-1 TO 
3:PRINTThat is OK! SELECT ON 
a~1-PRINTOne!-2:PRINT Two! 


That was the theory. Let us 
now look at a few simple and 
practical examples. Listing 
three shows a fun little applica- 
tion of the SELECT statements, a 
compliment generator to cheer 
up any fed up QL users! You 
could also change this to an 
insult generator (!), or for a bit of 
fun, into a buzzword generator 
which selects long words at ran- 
dom to form impressive sound- 
ing phrases which you can 
casually drop into conversations 
to sound impressive! 

Listing four shows a more 
practical use. This shows how to 
enter a month and day number 
and use SELECT to help pre- 
vent errors and ensure you get 
the right number of days in 
each month, although It doesn't 
test for leap years, where there 
would be 29 days in February. 

The routine works by using 
short form SELECTs to check 
the ranges of values allowed 
and long forms to specify the 
number of days in a given 
month number. As normally 
specified, January is month 1 
and so on. There are other, bet- 
ter ways of writing such a rou- 
tine, but it is an excellant exam- 
ple of the use of SELECT. 


1946 PRINT'One' : STOP 
2966 PRINT'Two' : STOP 
36060 PRINT'Three' : STOP 
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Listing six 


19% CLS 


119 LET a = RND(1 


TO 3) 


126 LET line_number = 149 
136 ON a GO TO 1699,2699,3008 


149 PRINT'Program finished. ' 


15@ STOP 
1666 PRINT'One' : 


GO TO line number 


2469 PRINT'Two' : GO TO line_number 


3699 PRINT'Three' 


GOTO 


You may have wondered if, 
apart from ensuring that lines of 
a pro gram are sorted in the 
correct order, the line numbers 
have any other signif icance. 
The answer is yes - it is possible 
to make the program jump from 
its present line to another in a 
different part of the program. To 
do this, we use the GOTO state- 
ment, which is followed by a line 
number. In the following exam 
ole, line 110 is never executed 
when the program is started 
from the beginning: 


100 GOTO 120 
110 PRINTLine 110° 
120 PRINT'Line 120’ 


It can also be made to form a 
‘loop’, rather like REPEAT: 


100 PRINTHello ! '; 
110 GOTO 100 


In fact, you'll notice that the 
computer enters a GOTO com- 
mand as GO TO (with a space 
between GO and TO). You do 
not have to type it in like that, it 
will be quite happy for it to be 
entered as one word. 

The GOTO statement has little 
practical use in QL SuperBasic, 
since there are other com- 
mands which can be used to do 
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: GO TO line number 


the same things. Its disad van- 
tage is that by specifying line 
numbers it makes it difficult to 
follow a program, and difficult to 
figure out where blocks of code 


start and end. It is, however, very - 


useful when trying to convert 
programs written for other 
compu ters (Basic programs list- 
ed in a magazine or book} since 
these make more use of the 
command than the QL does. 


ON...GOTO... 


There is another way in which 
you can make decisions about 
what to do subject to the value 
of a number or variable. This 
one is shorter and some times 
more convenient than SELECT, 
but suffers from the problems 
with line number references Gis- 
cussed under GOTO above. 
This is also included in Super 
Basic because it appears in 
other versions of Basic. 

The command takes the form 


ON x GOTO 1000,2000,3000 


where x is the variable being 
tested and the numbers after 
GOTO are line numbers to 
choose. These signify the start of 
blocks of code to handle the 
result tt does not appear obvi- 
ous how the choice is made, but 
itis quite sim ple. If the value of x 
is 1, the first line number is cho- 


sen. If the value of x is 2, the 
second is chosen and so on. If 
the value is too low or too high 
for the amount of line numbers 
you've given, the computer gives 
an error report (Out of range} 
and the program stops. 

Listing five is a version of list- 
ing one, rewritten to use 
ON..GOTO.. 

Don't forget that the use of 
GOTO is frowned upon in QL 
SuperBasic, though there's noth- 
ing to stop a consenting adult 
using it in private with his/her 
Qu 


Getting lost! 


When using GOTO or 
ON..GOTO to make a program 
jump to another part of the pro- 
gram, it is possible that it might 
get lost and not know where to 
come back to after it has fin- 
ished the new block Programs 
are often written in sections like 
this, especially where two parts 
of a program use the same lines 
of code. It allows you to avoid 
duplication and repetition - a 
part of a program can be written 
as one chunk at the end and 
called with a GOTO from one 
point and from another point, 
though you have a problem try- 
ing to remember where to go 
back to. One solution is to use a 
variable to remember it Here, | 
will be using a REMark state- 
ment to mark out bits of code as 


Listing seven 


166 CLS 
119 LET a = RND(1 TO 3) 
126 ON a GO SUB 16969,20060,30006 


examples. A REMark statement 
is just that, a remark or com- 
ment to include information for 
you to read. It is ignored by the 
computer. The example is in 
listing six. 

Here, the variable line_number 
holds the number of the line to 
go back to after executing the 
block at the end of the program. 
This works, but is not very ele- 
gant (in fact it is downright horri- 
ble), 

SuperBasic provides a far bet- 
ter solution to all this. It has a 
command which allows you to 
jump to another section of code, 
remembering automatically 
where it came from. At the end 
of a section of cade is a 
RETURN command which tells 
the computer to go back to just 
after where the last call was. 
This block of code at the end of 
the program is called a subrou- 
tine, because it is not the main 
routine. The command to call it 
is not surprisingly GOSUB 
(which means go to subroutine). 
The GOSUB command is fol- 
lowed by a line number. When 
encoun tered, the program 
jumps to that fine number and 
continues until it reaches the 
RETURN statement, then jumps 
back to where it left off See the 
example in listing seven, 

SuperBasic provides struc- 
tures which are far more clever 
than this, doing away with the 
need for line numbers altogeth- 
er. These are called proce 
dures and functions and will be 
discussed in the next instalment. 


136 PRINT'Program finished.’ 


146 STOP 
160% PRINT'One' 


2096 PRINT'Two' 


: RETurn 
: RETurn 


3906 PRINT'Three’: RETurn 


A Fair Xchange 


Simon Goodwin reports on the long-awaited release of 
Xchange for the QL. 


his year Psion Plo 

gave permission for 

the West Midlands QL 

User Group to distrib- 
ute the full Psion Xchange 
suite to QL users. This package 
is potentially interesting to all 
QL users, as it may be freely 
copied and is a major update 
on the Psion software bundled 
with each QL You need at least 
384K ram and one disk drive 
to run the suite - the more the 
better. 


Part-Xchange 


This article explains the extra 
features in this version of 
Xchange, and discusses useful 
files which have been added to 
the PD release. Pirate copies of 
Xchange have circulated for 
several years, hacked from the 
Thor version, These should not 
be confused with the PD 
release, which has a cursor in 
the top left corner, so it will run 
with EXEC and multi-task with 
Basic, and comes with a full set 
of support files including printer 
drivers and tutorials. 

All the versions hacked prior 
to permissions being given by 
Psion that | have seen contain 
errors; one, styled as ‘Turbo 
Xchange’, is bloated by need- 
less extra code and will only 
work in conjunction with Qram 
or Qpac. Another hacked copy 
has 64 bytes missing from the 
start, so it shows no task name 
and you cannot control its 
memory usage, The new West 
Midlands version is 183718 
bytes long, and comes on a 
720K disk full but for three sec- 
tors. Accept no substitute. 


Xchange story 


Psion Xchange was born in 
1983 as a suite of four busi- 
ness programs for the Sinclair 
QL computer. The first versions 
were programmed in C and 
tested on a Vax mini-computer; 
they barely fitted the 128K QL 
memory, Subsequently Psion 
updated the programs to ‘ver- 
sion 2’, re-coding them in 
assembly language to boost 
speed and save memory. 

Xchange has four parts, famil- 
iar to QL users: Quill, Abacus, 
Archive and Easel. Sinclair 
supplied these as four separate 
programs, but the full Xchange 
suite combines them into a sin- 
gle task, about 180K long, with 
many extra features and 
improved communication 
between the parts. 

Once QL Xchange was com- 
plete Psion converted the code 
to run on ICL’s One Per Desk 
office workstation. This has the 
same 128K ram as a standard 
QL and much of the same 
hardware, but uses a bigger 
rom which holds the entire 
Xchange package and built-in 
software added by ICL The 
One Per Desk can run 
SuperBasic programs, but the 
interpreter must be loaded 
fram microdrive cartridge 
before use. 

For years rumours of a rom 
version of Xchange for the QL 
circulated, but it never arrived. 
Psion went on to convert the 
suite for IBM PC compatibles, 
launching the full Xchange at a 
price to maich the entire QL 
system, and PC-Four, a cut 
down version comprising four 
separate programs rather than 
the integrated set, 


In 1986 the Thor consortium 
started work on a follow-up for 
the QL, and paid £30,000 for a 
Thor-specific version of 
Xchange, combining the four 
QL packages into one task and 
adaing features from the One 
Per Desk version, In the event 
the conversion was much more 
work than expected, and went 
way over budget 

The Thor consortium tried to 
obtain further updates, but 
were unable to find the neces- 
sary finance. Thor version 3.90 
was the last official release of 
Xchange, although a few jolly 
japesters have patched the ver- 
sion numbers of copies to 
make them seem more up to 
date. 

On 23rd February 1993 
Psion Ple generously gave per- 
mission for the distribution of 
QL-specific Xchange software 
freely (while retaining their 
rights), for the Sinclair QL and 
its derivatives plus the Thor XVI, 
Amiga and Atari running Qdos. 
The PC versions (Xchange and 
PC Four) are not affected by 
this decision, and must not be 
copied except under commer- 
cial licence from Psion. 

A few days later former 
Dansoft boss Helmuth Stuven 
contacted Sinclair QL World 
to announce that Thor bundled 
software was also freely distrib- 
utable. This meant that QDUMP 
and other Dansoft accessories 
could be included in the new 
release. 


Getting started 


If RAM1_ is available you can 
start the Xchange task direcily 
with an EXEC, EXECUTE or EX 
command. Xchange requires 


about 500K including for 
default SOOK data-area, and 
also uses space on RAM1_. 
You can reduce the data-area 
available for Xchange tasks by 
adding a parameter (eg EW 
"XCHANGE""9C" for 90K) in an 
EW, QW or EXECUTE_W 
Toolkit command. There's no 
need for a ‘grabber’ to stop the 
task taking all your memory. 

If you have no ram drive you 
can simply put the Xchange 
disk in drive 1, then load 
Xchange with the command 
LRUN FLP1_BOOT. This sets 
up a 50K ram disk; edit the 
SuperBasic if your machine 
has a built-in ram drive, or con- 
sult INTRO_DOC to find out 
how to change the size. 

The main Xchange menu is 
new to QL users, and lets you 
start up to eight Psion tasks 
from the set of Quill, Archive, 
Abacus and Easel. It also incor- 
porates options like BACKUP 
which used to occupy the files 
menu in each task 

You swap between tasks by 
pressing F6 to return to the 
main menu, then selecting the 
next task from a menu. Only 
one task runs at a time, but 
‘background’ printing lets you 
print one file as you work with 
others. In general Xchange is 
faster than the QL tasks as 
David Oliver patched the code 
to remove redundant Qdos 
calls. 

The eponymous XCHANGE 
option lets you move data 
between tasks, automatically 
swapping screens and issuing 
EXPORT and IMPORT com- 
mands, but this will not 
EXPORT from Quill, even 
though that now boasts an 
EXPORT option. More flexibly 
you can program arbitrary 
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command sequences with the 
TSL Task Sequencing 
Language, which works like 
‘macros’ in other languages. 


Task sequencing 


TSL programs consist of a 
sequence of key presses, 
optionally interspersed with 
commands and line-labels, 
When you run the program, the 
commands and labels are fil- 
tered out, and the remaining 
characters are interpreted as 
though you were typing them at 
the keyboard. 

TSL programs are text files 
which can be generated with 
any Ascii text editor, including 
Devpac, ED, Editor, Soy and the 
Xchange version of Quill, which 
can export Ascii text Some QL 
Quill fans use a special printer 
driver to get the same effect If 
you use Xchange Quill the easi- 
est way is to press F3 O F for 
the files menu, then E to Export 
text, followed by the file name. 
The extension ._TSL must be 
supplied, or Quill uses the 
default EXP, which will not be 
recognised as a TSL file. 

Spaces appearing in the pro- 
gram may be significant. Except 
within a TSL command, any 
space in a program is interpret- 
ed as though you had pressed 
the space bar. Other key-press- 
es, like function keys, arrow 


TABLE — 


Equivalent key 
Carriage Return (ENTER) 
Escape key (ESC) 

Space (in TSL commands) 


Function 
Function 
Function 
Function 
Function 


key 
key 
key 
key 
key 
key 
key 
key 
key 
key 


Function 
Function 
Function 
Function 
Function 


SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 


Fl 
F2 
F3 
F4 
F5 


keys and Enter, are especially 
difficult to represent in a text 
file, so they have symbolic 
names which can be used 
instead of the character itself. 
These symbols use short 
mnemonics enclosed in square 
brackets. The TSL table shows 
valid symbols and their mean- 
ings. 

The standard QL keyboard 
does not include F6 to F10, but 
the equivalent codes are gen- 
erated by keying Shift with F1 
to F5, so [f10] corresponds to 
Shift-F5, which re-draws the 
entire screen. The sequence 
[sf5] represents Shift-F5, and 
has the same meaning. Thor 
Argos, Amiga Qdos and many 
extended QL keyboards sup- 
port the extra keys F6 to F10, 
and these come in handy when 
using Xchange - for instance, 
F6 calls up the main Xchange 
task control menu from any of 
the four packages, and F9 tog- 
gles between insert and over- 
write mode, like Shift-F4 in QL 
Quill, 


TSL commands 


You can include special TSL 
commands in a file as well as 
key-presses. Each command 
consists of an ampersand (&) 
followed by a distinguishing 
character, It must start at the 
beginning of a new line. Some 


Code 

[1t] 

(rt] 

{up ] 

{dn} 

[bpr] 
Lepr] 
(wlt] 
[wrt] 
{bln} 
{eln] 
[dlt] 
[art] 
[dwit] 
[dwrt ] 
{a@bln] 
[deln] 
[tab] 
[btab] 


PUOBDNHUAWNE 
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TSL COMMAND SUMMARY 


If the specified character matches the one pressed 

in response to the most recent &g, jump to the label 
specified. The test is case-dependent. To jump to @FUN 
if the last response to &g was ENTER, use: &= [cr] FUN 


Comment; the rest of the line is ignored. 


Display text to the user {see &p). 


End of program - stopeé TSL. 


Get character - waits until a key is pressed. 
The key press can later be tested with i=. 


INPUT; waits for text to be typed. After ENTER 
the text is passed to the task. 


Jump to the program line marked by the following 


label. To jump te the label @loop use: &j loop 


Disables TSL messages at the top of the screen, 
so Xchange prompts appear as normal. 


Permits TSL messages. This is the default. 


Wait for this number of tenths of a second. 


To wait for six seconds use: 


&w 60 


Wait for a specified key to be pressed; e.g. 
&x A waits for the capital A key to be pressed. 


Wait for a specified key to be pressed; ignore case. 


of the commands accept text 
or numeric parameters. TSL 
supporis eleven commands, 
also listed in the table, 

Lines may be labelled with 
text so that commands can 
refer to them by name. Labels 
names start with an at (@) char- 
acter and must be the only 
thing on the line. You should 
not include the at sign in com- 
mands that refer to the label, 
such as &J , similar to Basic's 


Xchange TSL Key Codes 


Equivalent key 
left Arrow 
right Arrow 

up Arrow 

down Arrow 
SHIFT up 

SHIFT down 
SHIFT left 
SHIFT right 

ALT left 

ALT right 

CTRL left 

CTRL right 
SHIFT CTRL left 
SHIFT CTRL right 
SHIFT ALT left 
SHIFT ALT right 
TAB 

SHIFT TAB 


GO TO, or &=, which resem- 
bles an IF test. 

The special meanings 
assigned to square brackets, @ 
and & signs, make it difficult to 
enter them literally in TSL, so 
Psion use “ as an ‘escape’ 
character, rather like \ in C or 
Unix. ff you want TSL to take 
one of these characters literally, 
add a “4 before it, so &- A4@ 
HOME sends TSL to the line 
labelled HOME if the last key 
pressed was @, and &x 4“ 
waits for the “ key-press, 

To start a TSL tutorial, press 
F6 (or Shift-F1} to return from 
the current application if the 
Xchange menu is not yet dis- 
played, then press F3 and T, 
then enter the TSL file name. 


Documents 


The néw documentation con- 
sists of a two page introduction 
and three pages of TSL details, 
plus 26 demonstration _TSL 
files which show the extra fea- 
tures of Xchange in action. 
These tutorials range in size 
from a hundred bytes to 3OK 
or more, and have been collat 
ed from several sources includ- 
ing CS7, Dansoft and Chas 
Dillon, and adapted to link from 


one to another, starting with 
BEGIN_TSL or MENU_TSL 

The original THOR 1 
README_DOC is included on 
the disk, along with the pro- 
grams that it mentions that 
work on the QL The package 
also includes about 100K of 
context-sensitive help files. If in 
doubt at any time, press F1 for 
help from Xchange itself. 

The Thor's PC-style keyboard 
includes HOME and END keys 
which are intended to move the 
cursor directly to the start or 
end of the line. Xchange recog- 
nises these, and you can get 
the same effect on a normal QL 
keyboard with Alt-left and Alt- 
right 

The Xchange Quill Glossary 
is similar to Toolkit II's ALTKEY 
feature, or the key-define fea- 
ture in Turbo-Quill (which is not 
compatible with Xchange}, It 
lets you assign a sequence of 
characters to any alphabetic 
key, and call them up with the 
glossary key F5, unused in QL 
Quill. 

To teach Xchange a Glossary 
key, press FS twice, then the 
letter you want to assign, fol- 
lowed by Enter. From that point 
onwards until you press F5 
again, Quill records all the keys 
you press, up to a maximum of 
250 key-strokes. Once a glos- 
sary is set up you can call up 
the sequence by pressing F5 
and the chosen letter. 

Psion suggest that you could 


use the glossary to save typing 
common phrases, like ‘yours 
sincerely or your own address. 
Current glossary definitions are 
saved when you quit Xchange 
and retoaded when you start 
again from the same disk. 


File types 


The new EXTRACT option on 
Quills Files Il menu lets you 
write part of a file to disk in 
Quill's _DOC format, with for- 
matting intact You can then 
use MERGE to load it else- 
where. This is quicker than 
COPY even if you are just mov- 
ing the block from one end of a 
file to the other, as you can use 
GO TO or other commands to 
move once the block has been 
extracted. By default the block 
is stored in BUFFER_DOC on 
the default drive, but you can 
specify an alternative name or 
device - | normally use RAM1_. 

Quill documents have two 
main parts - the text, and the 
paragraph table which keeps 
track of the format and grows 
periodically as the file expands. 
Quill generates a new para- 
graph table for extracted 
blocks, so you can often 
reduce the size of a _DOC file 
by selecting it all as a block, 
and extracting it this eliminates 
space which may have been 
added to the paragraph table 
but not yet used. i use this tech- 


XCHANGE TASK CUNTROL 


Use space to select the tusk 
F2 Press ENTER to start the tusk 


TASK TABLE 


QUELLE 


~ Acharge 
QUILL =~ Action 
ABACUS - Eric 
ARCHIVE - Simon 
EASEL - DIYlook 
ABACUS - NEW TASK 
QUILL - NEW TRSK 
ARCHIVE - NEW TASK 
EASEL ~- NEW TASK 


MEMORY USED 


help 


nique to ensure that DIY Toolkit 
text files fiton 128K QLs, which 
limit Quill to documenis of 
around 10240 bytes. 

Ascii export is a long-awaited 
feature added to the FILES 
menu in Xchange Quill. 
EXPORT writes the entire file to 
a drive, removing control 
codes. Unlike SAVE it does not 
forget the cursor position, so 
you can carry on from just 
where you left off. MAIL is 
another new FILES option. It 
generates personalised form 
letters by merging a template 
document with data from the 
keyboard or a _DOC or _EXP 
file. 


Better names 


By default Xchange uses the 
same eight-character file 
names as QL packages, adding 
a three-character PC-style 
extension to distinguish 
between file types, but one of 
the nice Thor extensions 
means you can specify a full file 
path, allowing direct access to 
sub-directories or files grouped 
by prefix. 

You are not restricted to the 
three-character extensions, 
although you may avoid confu- 
sion if you stick with them. For 
instance F3 S flp1_DIY_TEST 
generates a file called 
“DIY_TEST’; you have to specify 
flo1_DIY_TEST_DOC to create 


default flpi_ 
ni_flpi_psion_help_ 


PRINTER STATUS 
not printing 


exec flpl_HPDUNP_TASK; "PRT" 


TEST_DOC in sub-directory 
DIY. The default devices are 
derived from the PROG_USE 
and DATA_USE names set up 
by most disk systems, but you 
can change these with the SET 
option from the Xchange F6 
menu. 

The first default is used to find 
data files, unless an explicit 
device Is named. Curiously, it is 
also used to find printer files 
such as GPRINT_PRT and 
XCHANGE_DAT, The other 
default tells Xchange where to 
look for help files. These are 
extended versions of the helo 
files used in the QL bundle, and 
include a new file, 
XCHANGE_HOB, which 
explains new commands in the 
Supervisory F6 menu, 


Abacus 


The Abacus spreadsheet 
recognises the same functions 
as the QL version. The FILES 
menu includes a new ‘transfer’ 
option to save or load the 
spreadsheet as an Ascii DIF file 
or in Psion’s own binary ABT 
format. There is no FORMAT 
option here or elsewhere, but 
you can Control C out to Basic 
any time you need to format a 
disk or cartridge. 

The new TITLES command 
fixes outer rows to the border, 
so beyond the cursor scrolls 
while the headings stay put 
The GRID menu gains many 
new options. PROTECT and 
UNPROTECT Iet you guard 
cells against overtyping over 
formula amendment SECURITY 
protects spreadsheets with an 
eight character password. 
REPEAT re-calculates the num- 
ber of times you indicate while 
GOALSEEK re-calculates until 
the supplied formula evaluates 
to zero 


Easel 


Easel now supports 3D 
graphs, changing the viewing 
angle automatically so you can 
always See the height of all the 
bars. It gains some new func- 
tions: RAD and DEG work like 
their Abacus namesakes, while 
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Fair XChange 


CELL and CELLMAX return the 
indices of the ‘cells’ that hold 
columnar data. 


Archive 


Archive gains the LOAD USR 
command added to the 
Archdev development version. 
This loads position-independent 
machine code which can sub- 
sequently be called with the 
USR function. This takes two 
parameters. The first, a long 
word, is passed in and out of 
the code via register DO, The 
second must be a string vari- 
able. The address of a string, 
prefixed by a length byte, ends 
up in register AO. The code can 
modify the text but must not 
change the length. 

The file must start with the 
characters "PMCO", followed by 
a word value - the length of the 
subsequent code, in bytes. 
About 1K of stack space Is 
available and all the registers 
may be used. The code should 
end with an RTS instruction, 


Printing 


Psion's slow and memory- 
hungry INSTALL. BAS has been 
replaced with a compiled ver- 
sion, but otherwise works just 
like the QL equivalent QL 
PRINTER_DAT files work as 
soon as you rename them to 
XCHANGE_DAT. 

A new program, 
CHOOSEPRINTER_BAS, lets 
you pick your printer definition 
from a range of pre-set files for 
SER and PAR devices. These 
support about a dozen old 
matrix and daisywheel printers, 
but few recent models apart 
from Epson-compatibles, Of 
course you can edit the exist 
ing files if you find something 
that is almost but not quite what 
you need. 

| have added a simple 
DeskJet definition for the most 
commonly-used Quill control 
codes, but this does not cur- 
rently support superscripts and 
subscripts. If this bothers you, 
add the sequences tabulated in 
Open Channel in issue 5 
(May) earlier this year. 
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Extension files 


The public domain ramdisk 
from Amiga Qdos appears on 
the disk, in case would-be 
users need a way to set up 
RAM1_, which is required for 
temporary files as Xchange 
runs. XCOPY_BAS is a fast 
copier for the Xchange task file, 
which uses a temporary buffer 
in memory to save and load the 
entire file in one go. You need 
to instalt SuperToolkit 2, or load 
Mark J Swift's PD Toolkit (LRUN 
FLP1_PDTK_BOOT} to use 
XCOPY_BAS. 

QDUMP_INSTALL_BAS has 
been altered to work on 
Sinclair roms, Amiga and Atari 
emulators, and Minerva (in one 
or two screen mode}, by 
adding a SuperBasic 
SYS_VARS function to emulate 
the Thor rom equivalent You 
may delete those lines from the 
end of the listing if you habitual 
ly use Argos or Turbo Toolkit 3, 
which implement SYS_VARS 
more flexibly as a resident func- 
tion. 


Limitations 


There are still a few bugs in 
Xchange that were fixed in very 
late releases of the separate 
QL tasks. In particular, the index 
used by Archive is limited to 
32K, as on QL versions before 
2,38. The Archive program 
token format is ihe same as 
that used by Runtime Archive 
and ArchDey, and different 
from that of QL Archive version 
2. 

You can load Ascii program 
files with the extension _PRG, 
regardless of their source, but 
tokenised files with the exten- 
sion _PRO may need to be 
converted before they will load. 
The easiest way to do this is to 
load them with your original 
copy of Archive and save them 
out as _PRG files. 

Quill sometimes gets the cur- 
sor position wrong while edit- 
ing, as was common before QL 
version 2,36. If this happens to 
you, press Shift-F5 (or F10 on 
extended keyboards) to re- 
draw the screen and fix the 
cursor. 


David Moseley and Rich 
Mellor of West Midlands 
Quanta report a bug in the 
Xchange version of Abacus, but 
this only affects late Minerva 
roms, like their version 1,93. 
When they try to Amend an 
Echoed formula the QL crash- 
es in what Tony Tebby once 
memorably described as ‘fart 
and pyjamas’ mode, with a 
striped screen and random 
noise from the speaker and 
microdrives. The fault does not 
appear on a JM machine with 
Gold Card, Amiga JS, or Phil 
Spink's early Minerva 1.64, so 
this seems to indicate a new 
Minerva bug. 

Psion have always had trou- 
ble coping when memory runs 
short, and this is true for 
Xchange, despite many fixes. 
The suite can get stuck if it 
runs out of memory on RAM1_. 
To avoid trouble, make sure 
there's plenty of room for tem- 
porary files on RAM1. before 
you start. Xchange generates a 
small file XCHANGE_TMP for 
task details, and one temporary 
file - similar to DEF_TMP on 
microdrive - for every task in 
use, They disappear when you 
Quit from Xchange. 


Obtaining 
Xchange 


The new release of Xchange 
is available free to members of 
the West Midlands QL User 
Group, a Quanta sub-group 
which meets on the first and 
third Monday of each month at 
the Holloway pub, just off 
Birmingham's Inner Ring Road. 
Bring a blank 3.5-inch disk to 
any meeting to get your copy, 
Non-members should join us! 
Or send an empty 720K for- 
matted disk to the secretary 
with return postage and pack- 
ing and a cheque or postal 
order for two pounds, made 
out to QL User Group (WM). 
Write to Mike Bedford White 
at 16 Westfield Road, 
Birmingham, B27 7TL, UK. 
Xchange is also available from 
other Quanta groups, and 
Qdos PD suppliers like 
Qubbesoft and SUPD. 


Payment Power 


Peter Examples of Soreens 


Tomlin’s QL saSSSSSESSssS555555 


keeps track Last reading vas 30753 


e What is present reading ? 30787 
of his Enter tine & date <hhian Ot Han Day) 


e.g. 09:00 09 Jul Thu This reading -) Units used -) 271 
household > 28 


costs. To calculate cost: 


Standing Charge £12.22 (units @ 7.51p) 


Last reading -) | 30998] Units used then 
(on 16 Sep ) ~) 610 


~ at tine of Official Reading:- 
~ at any tine:- 

- of nightly useage:- 

electricily Just to see previous useaget- 
consurmpion Just to see Tast 2 bills:- 
Vvalled se 
much. [l was mol just al 


weekends wher everyone was Last bi I] | dun Bi lI 


al horne. | used my CURIS to Reading vas 30938 | 30388 
Sel out cally meter readings, i 
bui | soon wanted more date Units used were 610 ! 669 
io hang, and il pecans a ; ! 
and laborious shilling aroun Cost of Units £45.81 | £43.97 
Standing Charge £12.22 1 £42.16 


€ wondered 
why oul 


Cost so far is -) 1£32.72) = £20.5 + St.Chge £12.22 


Last this Units Cost of Tine & date 
reading reading used units used of reading 


09300 
09:60 
09:00 
09100 
09:00 
09:00 
09:00 
03:00 
09:00 
09:00 
13:08 


Official reading today, 16 Sep 


Standing Charge £12.22 


(he Spreadsheet all thre lipiy 
to get what | 


SO gradually | 


Bill total £58.03 ! £62.13 
! 


asat i6Sep } asat 10 an 


reduce our Bills. 


Simple SuperBasic As 
Enter retar reading fron this bill 29719 

; How reading fron bill before that 28001 

lhe SuperBasic program 


ooes notrequire much (units @ 7.51p) 


explaining. Sorre of us do ret Fron this bill 

have ac ExT WOOIKIS enter tine & date Ghhinm Dt fem Day) - quess tine Last reading -) Units used -> 610 
wh (accllill o RERAME, are gi’ . G9 Jul The Last tine -> 669 
OPLEIs, OVER evRITE ‘ies, su : — on 10 Jun 
things A ti Kepr as 

SUI ng vane allen This bill vill be -) Last bill - £62.13 
One: Gish, Mav odio course 


be substiuled for fp, 
When Starting i use Ihe 
prograra fer the ‘first urvie, 


ery 
Ihere is another program 
called “Slarler”, vhich lattialus 


« Input Screen for “Nu” Procedure. 


- Menu Screen. 


clear off old data and begin oe Procedure “Look” output Screen. 
vicar dele condelaues 4. starter Program input Screen. 
infers has accumulated, 5 


Atihe start a’ both progiains 


ene has the opuon oF 


- Procedure “Now™ output Screen. 


- "Nu" output & “Seelog" Screen. 


« “Het” ocutput Screen. 


GiMarcnil 


AarieshiGs thier: imi Weees pe insea kl. oF eg 


session the facility can be 
accessed agaln by RUNning 
the program again. In the very 
beginning the facility would 
have io be used In the Starter 
progiarn, ang also In the Main 
program. But all this is only 
necessary If the Unit Price and 
Standing Charge have bbeen 
changed by the Gas or 
Electricity suppliers, 


The Menu 


Next, there Is the list of 
commangs, or the Menu. 

Procedure “Met", when 
seg, will permanently update 
the record and let you know 
what the bill Is, after lhe meter 
reacer has been and before 
the bill arrives In the post. 
Whether oc not you feel thai 
you need this Information 
stlaleh! away, It will be 
neeced eventually lo update 
the program, 


The procedure 
“Now” only 
reads the record 
to tell you how 
much bill you 
have run up so 
far. Nothing is 
permanently 
altered by this. 


“Nu" Is the procedure | 
Stanied wilh. It updales a 
continuous record of all your 
perlodic reaaings with the tine 
ana dale alongside, so thai 
readings can be relalec lo 
conditlons on thal day. After 
breakfas! was the best time for 
us to lake a reacing, when 
only the fride and the freezer 
would be In ongoing use to 
this evening. 

The running record can be 
viewed al any tine ‘without 
causing alterations by using 
ihe procedure *“Seelog”. 

The procedure “Look” will 
show both bills from the last 
wo official quarterly readings. 

The groups of figures 
printed in the oddly-numberea 
line 203) ate simply to assist 
In spacing out the following 
ling, and can be elirminatec Ii 
desired. 


Progras *Starter* 

100 MODE 4 

110 WINDOW #1, 462,206, 26,10 

120 WINDOW $2,462,206, 26,10 

130 WINDOW #0, 462,40, 26,216 

140 PAPER #1,0:PAPER 92,0:CLS: INK 4:CSIZE 0,0: 1K #0,7 

150 UChge = 7.51:SChge = 1222 :REMark >>> all in pence! <<<* 
160 PRINT\A\\\* Based on: Units"!UChge;"p & Standing charge 


£°;SChge/100;°," 

170 PRINT" ste cuss sazaz* 
1B0 PRINT\" if correct enter OK* 

190 PRINT* zaczesss* 

200 PRINT\® if different enter No” 

210 PRINT* sausezzs" 


220 REMark ###8SS2EEEREEERSEEEESESESEAELEESSEEESESES 
230 DEFine PROCedure Wo 

240 CLS 

250 IWPUT\\\\" Enter unit price IN PEWCE:- “!UChge 
260 INPUT  * Enter standing charge IN PENCE:- *'SChge 
270 CLS 

280 60 TO 140 

290 EWD DEFine Wo 

300 REMark #HStheRESEEEEAESSEEAEERAEREREEEEAEEEEIIEE 
310 DEFine PROCedure OK 

320 CLS 

330 IWPUT\\\\" = Enter meter reading from this bill™!a 
340 INPUT" Now reading frow bi}l before that"!b 
Wocza-b 

340 d = INT(UChge # c)/100 

370 PRINT\” ~=—s- From this bill’ 

380 PRINT" enter tise & date (hh:am Dt Mas Day) - quess tine if 
uncertain.” 

390 PRINT" e.g. 09:00 09 Jul Thu" 

400 INPUT* ~-> "tins 

410 DELETE fipl_test_tile 

420 DELETE flp!_newtest file 

430 DELETE flpi_seter file 

440 OPEN_NEW 85, flpi_test file 

450 OPEN_NEW #4, fipl_seter file 

460 PRINT #5, b\a\c\d\tias 

470 PRINT #4, a\c\d\tin$i7 TO 12)\SChge/100 

480 CLOSE #6 

490 CLOSE #5 

500 LRUN fipt Bill 

510 END DEFine OK 


Main Progras “Bill” 

100 MODE 4 

110 WINDOW #1, 462,206, 26,10 

120 WINDOW $2,462,204, 26,10 

130 WINDOW #0, 452,40, 26,216 

140 PAPER #1,0:PAPER #2,0:CLS: INK 4:CSIZE 0,0: INK #0,7 

1530 UChge = 7.51:SChge = 1222 :REMark >>> all in pence! <<<" 
160 PRINT \\\\\" Main Prograa® 

170 PRINT" ===s222s2222* 

180 PRINT Based on: Units*!UChge;"p & Standing charge £; 


SChge/100;".* 

190 PRINT* —---- =ssz auzaa" 
200 PRINT\* if correct enter DK" 

210 PRINT" ezszsszs" 

220 PRINT\" if different enter No* 

230 PRINT® samsczss" 


740 REMark HEPEREHSEREE ESSERE EAST EA EGET ESHEETS 

26 DEFine PROCedure No 

260 CLS 

270 IWAITVAAN" Enter unit price IN PENCE:- *!UChye 
280 INPUT = * ~— Enter standing charge IN PENCE:- "!SChge 
290 CLS 

300 PRINT: PRINTLPRINT1 PRINT 

310 60 TO 180 

320 EMD DEFine No 

330 RENarke Geedteeaaeereaeeneaetteeeee aed intt 

340 DEFine PROCedure display 

350 CLS:CLS #0 

360 OPEM #6,6cr_S5xhba235u175:PAPER #6,7:CL5 #4: INK 6,0 
370 BORDER $6,2,2,2 

30 OPEN #7, scr bixlbaZSouiSesPAPER @7,0:CL9 S7:iNK 47,4 
390 BORDER 97,2,2,2 

400 DPEW @6,scr_d5xlba23SchbrPAPER #8, 0:CL5 #8: INK #0,4 
410 BORDER #8, 2,2,4 

420 END DEFine display 

430 RENark F4RCREEEEEHEEEREECEEGEEERSEDEREEEEEE 

440 DEFing PROCedure OK 


450 CLO:CLS #0 

460 CSIIE 0,12AT 91,2, 11:PRINT*Commands* 

470 CSIZE O,0cAT #1,4, LLaPRINT"----~--- F 

480 AT 41,7,11:PRINT "To calculate cost: Enter* 
490 AT 91,8, 48:PRINT *--------- . 

500 AT 41,9, 1:PRINT "~ at time of Official Reading:- Het" 
SIO AT 1,11, 1oePRINT "- at any times Wow" 
520 AT #1,13,14:PRINT "- of nightly useage:- Nu" 
530 AT #1,15,10:PRINT "Just to see previous useage:- Seelag* 
S40 AT €1,17,16cPRINT “Just to see last 2 bills :- Look” 
550 END DEFine OK 


SOO REMark SERCHHEESEHESHEREEEEES ERE SEO CHEESE 
‘570 DEFine PROCedure cue 
580 PRINT #0," 
590 END DEFine cue 
O00 REMark #e0GEtOReeteEeHeeeeSeSGeeeeeeeasttee 
610 DEFine PROCedure Net 
620 LOCal r,s, t,uy vO, a,x, 7S,2 
630 GPEN_IN 45, flpl_aeter_file 
640 CLSICLS 00 
650 PRINTs PRINT: PRINTsPRINTs PRINTS PRINT 
660 INPUT" What is present reading ?  "'r 
470 PRINT" Enter date (Dt Mas)" 
680 PRINT® e.g. 09 Jul* 
690 INPUT" =a) “lyt 
700 CLS 
710 display 
720 PRINT 88," "sr 
730 PRINT 
740 PRINT 
750 PRINT 
7a INPUT 45, 
770 INPUT 85, 
| 780 EWPUT 85, 
790 INPUT #5, vi 
| 800 INPUT 45, 2 
| B10 CELE O,beAT @1,1,25:PRINT"Official reading today, "'y$ 
820 COIZE O,0rAT €1,4, 25sPRINT"-------------~----~---~------- 7 
O30 AT #1,17,1200NK 2:PRIMNT "This bill will be -->" 
B40 AT BL, 47,472PRIMT*Last bil) -> £";u + 2 
G50 PRINT #7," "hs 
\ O60 wer -s 
870 AT O1,13,47:PRINT*Units used -)"'w 


Enter OK for Menu" 


ocovre 


O80 AT #1, 14,47:PRINT"Last tine -)"!t 

B90 AT #1,13,121]NK 2:PRINT"Last reading ==)" 

900 AT €1,15,472INK 4:PRINT* -> on" lye 

910 AT 81,9, 12:1MK 2:PRINT “Standing Charge 
(units @ ";UChge;"p)" 

920 x = INT(UChge # w)/100 

930 PRINT 

940 PRINT 

950 PRINT 

960 PRINT 04," £";x + (8Chge/100) 

970 CLOSE #5 

980 DELETE flpl_seter_file 

990 OPEN_WEW #4, flpi_meter file 

1000 PRINT #4, r 

1010 PRINT #4, « 

1020 PRINT #4, x 

1030 PRINT #4, y$ 

1040 PRINT #4, SChge/100 

1050 PRINT #4, 5 

1060 PRINT #4, ¢ 

1070 PRINT #4, «& 

1080 PRINT #4,¥s 

1090 PRINT #4, z 

1100 CLOSE #4 

1110 CLOSE #6 

1120 CLOSE #7 

1130 CLOSE #8 

1140 cue 

1150 IK 4 

1160 END DEFine Met 

1170 REMark #0GtdRSEREREEEEHAEESEREEEOSHEREEEERE 

1180 DEFine PROCedure Mow 

1190 LOCal rys,t,uyvO,myx,z 

1200 PAPER OcCLSr INK 4:CSIZE 0,0 

1210 CLS 60 

1220 OPEN_IN 95, fipl_seter tile 

1230 INPUT 45, 5 

1240 INPUT #5, t 

H 1250 INPUT #5, u 

1260 IWPUT #5, v$ 

1270 EWPUT #5, 2 

1280 PRINT 

1290 PRINT 

1300 PRINT 

1340 PRINT 

1320 PRINT" «As at" !v$!"Bill reading was*'s 


1330 INPUT" What is this reading ?*'r 
IMOwsr-s 

1350 x = INT(UChge # w)/100 

1360 display 


Cost so far:” 


Sete a hee tad 


1370 CSIZE O,1sPRINT\ * 
1380 C&IZE 0,0rPRINT * 
1390 PRINT @6,° "sr 

‘ 1400 PRINT 

1 1440 PRINT 

1420 PRINT 

1430 AT €1,17,122IWK 2:PRINT “Cost so far is ~~)" 
1440 PRINT B77," "ps 

1450 AT 41,6, 12:PRINF*This reading aay 

1460 AT 01,5, 47:PRINT"Units used ->"'0 

4470 AT #1, 17, 40sPRINT*= f*5x!* + St.Ch.£";SChge/100 
1480 AT #1,13,42:1NK 2aPRINT*Last reading a al 
1490 AT 41,14, 12¢PRINT® (on* 'v8;")" 

1500 AT @1,13,47:PRINT*Units used then” 


£";SChge/100;* 


1510 AT #1,14,583PRINT"-)"¢t 

1520 AT 1,9, 12:PRINT "Standing Charge” 

4530 AT #1,9,38:PRINT "£"3SChge/i00;*" (units @ “;UChge;"p)* 
1540 PRINT 

1550 PRINT 

1340 PRINT 

1570 PRINT #6," £";x + (SChge/100) 

1580 CLOSE #5 

4590 cue 

1600 [WK 4 

1610 END DEFine Wow 

1620 REMark SROGREESETESESEESEPESESECHHESEEEEEEE 
1630 DEFine PROCedure MU 

£640 LOCal fygyhyi,i$,1,a,n8 

1650 CLE:CLS #0 

tbo0 DELETE tip! _newtest file 

1470 OPEN_IN #4, FLPI_test_file 

1680 OPEN MEW 87, flpl_newtest file 

16% REPeat log 

1700 IMPUT #4, f 

1710 IWPUT #4, 9 

1720 INPUT #4, 

1730 IWPUT #4, i 

1740 INPUT #6, j6 

1730 PRINT 87, 
1760 PRINT 87, 9 
1770 PRINT 87, h 
1780 PRINT 87, i 
1790 PRINT 87, j$ 
1800 IF EDF(#6) THEM EXIT log 
1610 EWD REPeat log 


~ 


1820 CLOSE #4 

1830 PRINT\\\" Last reading was | 
1840 INPUT* What is present reading ? "'k 
1850 PRINT\" Enter tise & date (hh:ma Dt Maw Day)" 
1860 PRINT\* e.g. 09400 09 Jul Thu® 
1870 [WPUT* —> "Ins 

1080 | =k ~q 

1890 @ = INT(] # UChge) /100 

1900 PRINT 47, 


1910 PRINT 47,k 

1920 PRINT 47,1 

1930 PRIWT 47,0 

1940 PRINT 87,n9 

1950 CLOSE #7 

1960 DELETE FLPL_test_file 

1970 COPY fipl_newtest_file TO FLP1_test_file 
1980 seelog 

1990 END DEFine MU 

2000 REMark #ERERSESOEEEERSEEECEROEEEEOESHHEEG HE 
2010 DEFine PROCedure seelog 

2020 LOCal a,b,c,d,e8 

2030 CLS: CLS # 

2031 REMark 123456789 123456789 123456789 123454789 123456789 123456 


2040 PRINT\" = Last = this = Units Cost of Tise 
4 date" 

2050 PRINT “ = reading reading used units used of 
reading” 

2080 PRINT 8n-—-annanennnnn nnn nn nn anne ann nnn nn nnn nnn cond 


2070 OPEN_IN #9, FLPi_test file 
2080 OPEM #10, SCR_440x154a50x55 
2090 REPeat viewlog 

2100 INPUT #9, a 


2110 INPUT 49, 
2120 INPUT #9, 
2130 INPUT 49, 
2140 INPUT 99, ef 

2150 PRINT #10, a,b,c,, "£";0,,e8 
2160 IF EOF (89) THEM EXIT viewlog 
2170 END REPeat viewlog 

2180 CLOSE #10 

2190 CLOSE #9 

2200 cue 

7210 END DEFine seelog 


an 


2220 RENark #8ESERREEEEREESRECSESEREESTEELEIEETE 


2230 DEFine PROCedure Look 

2240 LOCal a,b,c, d8 

2730 CLSsCLS 90 

2260 OPEW_IN #5, flpi_seter file 
2270 IWPUT 45, a 

2280 INPUT #5, 
2290 INPUT #5, 
2300 INPUT 65, d$ 
2310 INPUT #5, 2a 
2320 IF EOF(#5) THEN 


os 


2330 @ = 01 f = Or g = 1 h® * *-- date unknown": ze = 0 


2340 60 TO 2430 
2350 ELSE 

2360 INPUT #5, e 
2370 IWPUT 45, 
2380 INPUT #5, 9 

2390 [WPUT &5, h$ 

2400 INPUT #5, ze 

2440 CBIZE O,12AT 91,2, 32:PRINT “last 


~ 


Bill! "yhO(4 TO) ¢*Bill" 


2420 CSIZE 0, 0rAT #1,6,31:PRINT "**e**eoeese ere eesenennen 


2430 AT #1,7,14:PRINT "Reading was "ay" ye 
2440 AT 41,6, 442PRINT "1" 
2450 AT 91,9, 14:PRINT “Units used were Tiyyt ot Sf 


2460 AT #1,10,44:PRINT *2° 
2470 AT #1,11,14:PRINT "Cost of Units 


£"5cp" 1 £39 


2480 AT #1,12,14:PRINT “Standing Charge E"pray" ! Lyre 
2490 AT #1,13,34sPRINT "--------!—-----* 


2500 AT #1,14,14:PRINT "Bil} total 
2540 AT #1,15,44:PRINT "!* 

2520 AT #1,16,30sPRINT “as at? !d$;" 
2530 CLOSE #5 

2540 cue 

2550 END DEFine look 


E"yc + za"! £"5q + re 


! as at'hs 


re ere 


Help is sampled by Bryan Davies 


INFORMATION 

Program: HyperHelp for Basic 
v1.01 

Price: DM49 plus DM13 post & 
packing 

Supplier: Jochen Merz Software 
Develooment im stilen Winkel 
12 D-4100 Duisberg 11, 
Germany. Tel/fax (01049) 203 
501274 (from Uk) 

and: 

Price: £29 finclusive) 

Supplier Software&7, 33 
Savernake Road London NW3 
ZU, 


Th QL User Guide has 
Quaker its share of 
criticism, for containing errors, 
not containing enough informa- 
tion, being too large, etc, and it 
is more than possible that many 
users do not ever bother to 
open it This is a pity, because 


HyperHelp may not appeal to 
you, Read on, even so, 
because you might be per- 
suaded to give it a try 


On-line 


HyperHelp provides on- 
screen help for SuperBasic 
functions (in the wide sense, 
not just with a capital F), It 
works under the Pointer 
Environment and can be 
loaded concurrently with other 
jobs, making it a usable refer- 
ence tool while you are pro- 
gramming, It is designed to be 
"aware" - to work with other PE 
programs, such as the QD 
Editor from the same stable, It is 
also user-adaptable - you can 
add to, and alter, the text sup 
plied with this program. 

Something a little startling if 


the book really is not all that bad, 


and could answer many queries. 


The fashion these days, though, 
is to have “on-line help"; informa- 
tion right before you on the 
screen, and - hopefully - relevant 
io your current problem. As with 
other aspects of computing, 
there are at least two schools of 
thought concerning on-line help, 
and you may be of the school 
which simply does not like this 
kind of thing, in which case 
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you are not expecting it is that 
there are quite a few items listed 
on the HyperHelp screens that 
do not have any information dis- 
played for them, leaving gaps to 
fill in from the start This is not a 
major criticism, as there are now 
a large number of functions, and 
Jochen Merz cannot be expect 
ed to have traced all of them. He 
says that there are 500-600 
functions used in the QL, and 


perrelo 


New for Pointer Environment programs, on-screen 


——————— 


= ipl brsic HELP CIRCLE == 


his program lists 338 of these; 
how many of these do not have 
help text available would take 
too long to count, but a check 
on two screen columns - cho- 
sen at random - revealed 28 out 
of 36 functions without explana- 
tions. While some of the listed 
functions are unlikely to be used 
by most programmers, an 
average user may well make 
use of functions such as 
EXTRAS, and that is one of 
those which do not have 
details. {It is the Toolkit com- 
mand for listing the loaded 
SuperBasic functions, includ- 
ing add-on toolkit ones, to the 
screen}. More surprising, since 
Merz products tend to be the 
type which are bought by 
QPac users, is the lack of 
explanations for functions 
such as HOT_PICK(), 
HOT_STUFF and 
HOT_THING( 


Functions 


The first screenful you see 
when HyperHelp is called upon 
is shown in Figure one. It can 
be seen from this sample that 
the index centains functions 
from a variety of sources, and 
you may not have heard of 
some of them. The standard 
SuperBasic functions are 


explained, and that is what most 
users will presumably want As 
you acquire additional functions, 
whether with hardware Such as 
the Gold Card or software such 
as Professional Publisher, you 
can type in help details for them, 
As supplied, the program disk 
contained over 120 help files, 
the philosophy being that it is 
better to have a modular struc- 
ture for help rather than one big 
file, because it is then easier to 
make changes and additions 
with an ordinary text editor. It 
was also considered easier to 
provide links to other programs 
to make help available from 
within them, if lots of small files 
were! used, Another factor is that 
searching for a particular item in 
a large file could slow. The files 
are typically less than 1 KB in 
size, 

The help information does not 
need many words, in most 
cases; the QL User Guide 
descriptions are mostly brief 
HyperHelp is not meant to pro- 
vide a beginners’ guide to 
SuperBasic, but as a reference 
source for users who have a 
working knowledge of it howev- 
er limited. Figure two shows 
what is displayed on the screen 
for the functions CIRCLE, CIR- 
CLE_R, ELLIPSE and 
ELLIPSE_R, Where possible, 
several functions have been 
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covered on single screens, such 
as this one, When no informa- 
tion is available, you get the 
comments shown in Figure 
three, 

New data can be entered in 
different styles to suit the user's 
purposes, You can load the help 
files into word-processing pro- 
grams, such as Quill, Text8? 
and Perfection, or text editors 
such as The Editor or QDS. 
Figure four shows the file 


lem, but is rather time-consum- 
ing. Help is obtained by clicking 
the right mouse button, or 
pressing Enter, with the pointer 
over the HyperHelp button, 
dragging the pointer by mouse 
or keys until the desired function 
is enclosed by a box, then 
pressing Enter again. Space 
scrolls the screen by one line at 
a time, and Enter by a page, 
Operations are what experi- 
enced Pointer Environment 


Basic_HELP_CIRCLE !oaded 
into Perfection; compare this 
with the same data, as displayed 
on the screen, in Figure two. 
When creating a new help file, 
add a reference to that file in the 
index, Basic_HELP_INDEX. 

Other Merz programs will be 
supplied with Basic_ HELP_ 
INDEX_ADD, covering new func: 
tions as well as those already in 
HyperHelp. The user can load 
the basic index file into an editor, 
then append the _ADD index file 
to the end of it the whole file 
oan then be sorted and edited, 
to order everything and remove 
duplications (if any). Other pro- 
grams will also have their own 
help files, to be copied to the 
HyperHelp file directory. To get 
help on a specific function, point 
to it on the screen with the 
mouse pointer, then press F1, 


Keyboard too 


A mouse is desirable, but, like 
most Pointer Environment pro- 
grams, not essential. Albin 
Hessler's SERMouse was used 
during this review, and worked 
flawlessly, Moving the pointer 
with the cursor keys is no prob- 


users would expect, and are 
quite easy to understand for 
other users. Ctrl-C switches 
from HyperHelp to another pro- 
gram; when you switch back, 
the screen display is as you left 
it, so that you can put new help 
text on the screen and toggle 
quickly between it and the pro- 
gram you are writing. 

When you have had a Gold 
Card fitted for a year or so, you 
tend to forget what life is like 
with a basic QL, but there is no 
reason to think HyperHelp 
would be in any way unaccept 
able - as far as speed is con- 
cerned - on the basic machine. 
However, the program 
and extensions take a fair 
amount of space, plus 
the Help files; you proba- 
bly won't be able to load 
the latter into a ramdisk 
on a basic QL The 
review was done with the 
files left on disk, and the 
speed of access was 
quite acceptable. The 
drive used however was 
an ED (extra-density) one, 
which has a much better 
access time than DD or 
HD drives. The program 
defaults to searching the 
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FLP1_Basic_HELP. directory for 
help files, but it can be config- 
ured to look at any standard QL 
device. The ideal would be to 
have the files installed on a hard 
disk drive, and copied to 
ramdisk when the system is 
booted. You could keep the help 
disk in FLP2_ if programs and 
development tools are kept on 
disk in FLP1_. With ED drives, 
the greater storage capacity 
makes it much easier to keep 
everything on single disks, of 
course, 


The instructions supplied 
with the program are on five 
sides of AS paper, well-printed, 
and well-written. There is no 
need for more, since the pro- 
gram is so easy to use, 

The program disk contains 
files in both German and 
English, as usual with Merz 
Software programs, The Merz 
"house style’ is famitiar to me, 
but some buyers might be 
confused by the file names on 
the disk, and the instructions do 
not explain them. Various pro- 
gram files have ENGLISH as 
part of their names; likewise, the 
file names for the individual help 
files are English, and these are 
the ones to copy to your work- 
ing disk for help displayed in 
English. The supplied boot rou- 
tine will load the German ver- 
sion unless you change the file- 
name of the program itself (from 
HyperHelp to HyperHelp_English) in 
the boot, or rename the two files 
themselves. 

The program requires roughly 
120 KB of memory to run, over- 
all {this figure is not quoted in 


Memory needs 


the instructions, but is the differ- 
ence in free memory values 
before and after the program 
was loaded), if you do not have 
the Pointer Environment already 
on your system boot disk, you 
need about 35 KB of this for the 
files PTR_GEN, WMAN, and 
HOT_REXT. The program's own 
PE extensions file MENU_REXT 
requires over 20 KB. The help 
files, loaded into ramdisk, require 
about another 140 KB (but you 
can omit any functions that do 
not matter to you). You may well 
have other axtensions loaded, 
for application programs, and/or 
for hardware devices; for exam- 
ple, The Editor requires 5-10 KB 
of extensions, the Miracle hard 
disk drive requires around 50 
KB. Clearly, you cannot put all of 
this on a basic, un-expanded QL. 


Conclusions 


HyperHelp is just the kind of 
thing relatively-inexperlenced 
SuperBasic programmers could 
use. In fact, many non-program- 
mers would appreciate a quick 
reference facility for odd toolkit 
commands. It is not suitable for 
QLs without memory expansion. 
A good structure, with reference 
data which is easy to extend 
Average users should find no 
great difficulties, either in setting- 
up the program for their partiou- 
lar system configurations, or in 
adding their own help text. | felt 
let down in the version reviewed 
by lack of help on quite a lot of 
fairly common functions. Merz 
Software has undertaken to cre- 
ate compatible help files for all 
its own programs, given time. 
The price is reasonable, 
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Simon Goodwin crafts a Mouse Organ in Amiga SuperBasic 


rare to 
> | find 
S™ 
dis- 


Beethoven is | 
spinning in his 
grave 


cussed in QL World. The QL - REMark Amiga Qdos STEREO TONE GENERATOR 

BEEP function is rather eccen- | shall discuss music from REMark Uses 8 chip RAM bytes. Version 6 
, . ‘| | i j R i i 

tric and other approaches - like _ first principles, with a few refer- nore By Simon N Goodwin, 7 July 1993 


t Uses HEX, ALCHP, RECHP, SYSBASE 
MIDI and net sound - have ences for those with a knowl- 


made little impact But the 
Amiga Qdos emulator has 
access to impressive sound 
facilities, and it is surprisingly 
easy to use them from 
SuperBasic. 

This month's SuperBasic in 
Action project generates accu- 
rate polyphonic stereo sounds 
controlled by the mouse. It 
uses new PTR_ keywords intro- 
duced in Amiga Gdos 3.20, 
and direct access to the 
Amiga's sampled sound hard- 
ware. Unlike QL sound, you can 
control hardware filtering and 
edit the waveform and hence 
the timbre of the music. 

Even if you do not have 
access to an Amiga, the pro- 
gram is interesting as it calcu- 
lates musical intervals more 
precisely than the ‘even-tem- 
pered’ keyboard of pianos and 
other instruments, which are 
tweaked away from pure ratios 
to allow them to harmonise 
acceptably, but not exactly in 
any one key. Computers can 
generate more exact chords in 
all keys than such antique 
hardware, and it's a pity that 
most programmers stick to the 
twelve note chromatic scale 
when they have access to so 
much more. 


edge of music. I'm grateful to REMark Pentatonic musical constants 


Miles Walsh and my brother 
Sam for theoretical insights, 
Sounds and notes consist of 
repeated waves. Their frequen- 
cy or pitch increases as their 
‘wavelength’ decreases, and the 
waves arrive closer together. 
Chords are combinations of 
notes, generally those that beat 
together harmoniously, gener- 
ating interference patterns 
characteristic of the ratio of 
their frequencies. The waves fit 
together neatly and the combi 
nation of notes sound ‘in tune’. 
When the higher note has 
twice the frequency of the 
lower one, the notes are said to 
differ in pitch by an octave. So 
universal is the eight-note scale 
in western music that the inter- 
val between one note and the 
one at double its frequency is 
always called an ‘octave’, even 
when other divisions are used. 
Most western music divides 
the octave into twelve steps of 
one “semitone” along the piano 
keyboard in black and white 
notes. The thirteenth note, 
“eighth” or “octave” begins the 
pattern again at a higher pitch. 
Other pairs of notes use ciffer- 
ent ratios - for instance a gap 
of seven semitones on a piano 


root=2*(1/53) 
note2=root’9 
note3=root*17 
note4=root* 31 
note5=root*39 
DIM note%(39) 


here=28800;REMark Or 25920, or 32767 


FOR i=39 TO 4 STEP -5 
note%(i)=here 
note%({i-1)=here/note2 
notet(i-2)=here/note3 
note? {i-3)=here/note4 
note%(i-4)=here/note5 
here=here/2 

END FOR i 


REMark Limit of chip RAM 
chip_top=2*21 

REMark Hardware register labels 
pra =HEX("BFEOO1") 
G@macon =HEX("DFF096") 
adkcon =HEX("DFFO9E") 
audOlc =HEX("DFFOAO") 
audOlen=aud0lc+4 
aud0per=aud0lc+6 
aud0vol=aud0lc+8 

audlle =aud0lc+16 
audllen=aud0len+16 
audlper=aud0per+16 
audivol=aud0vol+16 


REMark Find some chip memory 
chip=ALCHP(8) 
fast_ram=(chip>=chip_top) 
IF fast_ram 

RECHP chip 


REMark Grab workspace beyond Qdos tables 


chip=PEEK_L( SYSBASE+124) 
END IF 
REMark Prepare simple wave table 
RESTORE 


REMark DATA -126,-90,-54,-18,18,54,90,126 
REMark DATA 127,127,127,127,-127,-127,~127,-127 


DATA 0,90,127,90,0,-90,-127,-90 
FOR i=chip TO chip+7 
READ x : POKE i,x 
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END FOR 1 


POKE_L aud0lc,chip 
POKE_L. audlic,chip 
POKE_W audOlen,4 
POKE_W audllen,4 
POKE_W audOper,789 
POKE_W audlper,789 
POKE_W aud0vol ,64 
POKE_W audivoel ,64 


POKE_W adkcon,255 :REMark No modulation 


HELLO : POINT 
AUDIO_ON 1+2 : cutoff=0 
REPeat sing 


POKE_W audOper,note%(PTR_X* DIV 6) 
POKE_W audlper,note%(PTR_Y% DIV 6} 
KS=INKEYS : IF k§$=" " :; EXIT sing 
IF k$="#" 3; cutoff=NOT cutoff : 


END REPeat sing 

AUDIO_OFF 1+2 

IF NOT fast_ram : RECHP chip 
CLS #40 : PTR_OFF 

STOP 


DEFine PROCedure POINT 
PTR_LIMITS 0,0,239,239 
PTR_POS 120,120 
PTR_INC 1,1 : PTR_ON 
END DEFine POINT 


DEFine PROCedure HELLO 
REMark Display note grid 


OPEN #3,8cr_480x240a0x0 : CLS #3 


FOR j=6 TO 239 STEP 6 
pen=3 + ((4 MOD 30)=18) 
BLOCK #3,2,240,3*2,0,pen 
BLOCK #3,480,1,0,j,pen 

END FOR 4 

REMark Overlay instructions 


FILTER cutoff 


keyboard comes close to a 
ratio of 3:2, another pleasing 
beat known to musos as a ‘fifth’ 
(the first and fifth note of the 
usual scale). 

To understand Western 
music theory you have to 
remember that a normal scale 
has twelve notes of which eight 
are normally used in any one 
key. The twelve notes start to 
repeat on the thirteenth, but the 
eight notes start to repeat on 
the eighth. Clear as anything, 
isn't it? 

The twelve-note scale on a 
normal instrument is less accu- 
rate for other intervals, like 5:3, 
5:4 and 9:8, because it doesnt 
have enough divisions. This is a 
shame, as these ratios are 
common in both Western and 
Eastern music, and have mani- 
fold musical names. But don't 
be put off. All that matters is the 
ratio of the wavelengths. 

The twelve- (or eight-) note 
scale gets from one frequency 
to twice that in twelve equal (or 
eight unequal) steps, but you 
only need to stop at five of 
these steps to generate all the 


The highest notes sound 
when the mouse points at the 
top left corner. Move it to the 
bottom right for deep bass. 
Press # to switch on and off 
ihe Amiga’s filter, which cuts 
treble to make the sound less 
harsh. Press SPACE to stop the 
sound and return to 
SuperBasic. 

The interesting thing is the 
variety of chords you get by 
moving the pointer sideways, 
up and down, Diagonal posi- 
tions give the same pitch from 
each stereo channel, and the 
notes separate in a pleasing 
pattern as you move away from 
that line. 


How it works 


The program derives note 
wavelengihs from an even 
scale of 53 notes, rather than 
the Western twelve-note scale. 
This would be unfeasible for a 
piano no-one has long-enough 
arms - but is no extra trouble 
for a computer, 

Line 1060 sets ROOT to the 


CSIZE #3,2,1 : OVER #3,-1 : INK #3,7 

PRINT #3,\," AMIGA QDOS SOUND DEMO"\\, 

INK #3,4 

PRINT #3;" Move the mouse to play a stereo sample" 
PRINT #3 \\ 

PRINT #3;" Top left gives highest pitches"\\ 
PRINT #3;" Bottom right for lowest pitches"\\ 
PRINT #3;" Press any key for silent SuperBASIC..." 


ratios | have mentioned. A five- 
note scale is known as a penta- 
tonic scale, and pentatonic 
scales are the basis of much 
ancient religious music and 


number which you have to 
multiply by itself 53 times to get 
2, sensibly known as the fifty- 
third root of two. Replace the 


CLOSE #3 
END DEFine HELLO 


DEFine PROCedure AUDIO_ON(x) 


REMark X =1, 2, 4, 8 for channels 1-4 on 


IF x>0 AND x<16 

POKE_W dmacon,x-32763 
END IF 
END DEFine AUDIO_ON 


DEFine PROCedure AUDIO_OFFP(c) 


REMark Turn off audio channels 1, 2, 4, 8 only 


IF l<=c AND c<=15 
POKE_W dmacon,c 

END IF 

END DEFine AUDIO_OFF 


DEPine PROCedure FILTER(flag) 
IF flag 

POKE pra,PEEK(pra) && 253 
ELSE 

POKE pra,PEEK(pra) || 2 
END IF 
END DEFine FILTER 


DEFine FuNction SYSBASE 
RETurn 163840 
END DEFine SYSBASE 
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20th Century Blues. If you're 
struggling to play the finale 
from Pete Townshend's 
Quadrophenia, try the black 
notes of the piano keyboard! 

(Start from D sharp, and youll 
have the pentatonic, aeolian 
modal or Blues, whichever you 
like to call it version of a nor- 
mal natural minor scale, Start 
on one of the other black 
notes, and you'll have some- 
thing totally different, as the 
step patterns will be In the 
wrong place. - triangle-piaying 
Ed) 

This program plays pentaton- 
ic music in a two-note chord 
over an eight-octave range, 
based on a scale with 53 equal 
divisions instead of 12. Why 
53? Because that works partic- 
ularly well. You select the notes 
by moving a pointer across a 
grid with the Amiga mouse. 
Red lines separate notes in the 
scale, and green lines mark 
each octave. 


value 53 with a temporary vari- 
able if compiling with Turbo or 
Supercharge, or the compiler 
will ‘optimise’ the integer 
expression 1/53 to zero, and 
all five notes will be the same. 
Oops. 

The next four lines pick the 
required ratios; 9, 17,31 and 
39 steps along the 53 note 
scale. If you use a twelve-note 
scale, use 3, 5, 7 and 10 and 
replace the 53 with 12. If it 
sounds better, you're hooked 
on convention, 

The array NOTE% holds 
ascending wavelength values 
for 40 notes. You may wonder 
why | don't just work out the 
ratios directly, The program 
evolved to allow easy experi- 
mentation with new scales and 
intervals while staying in touch 
with Earthly norms. The initial 
value 28800 was suggested 
by Sam because its factors are 
2,3 and 5, fitting the scales 
nicely without rounding errors, 


The pointer 


The Amiga hardware can 
move sprite images over the 
screen under program control, 
without disturbing the back- 
ground display. Amiga Qdos 
lets you turn on a sprite pointer, 
which subsequently moves 
around the screen under 
mouse control as your pro- 
grams run, 

The new functions PTR_X% 
and PTR_Y% return the position 
of the pointer within limits set 
by PTR_LIMITS. Co-ordinates 
range from 0 to 255 in each 
direction, like MODE 8 pixels. 
Line 1780 confines the pointer 
to an area of 240 units square, 
matching the grid window #3, 
opened in line 1850. Six units 
are allocated to each grid 
square, for 40 (240/6) notes in 
all. 

PTR_ON and PTR_OFF con- 
trol the pointer display, while 
PTR_INC lets you set the step 
for values of PTR_X% and 
PTR_Y%, If moving over text In 
CSIZE 3,1 you might set 
PTR_INC 8,20 to use charac- 
ter-sized steps. 


The hardware 


ach Amiga sound channel 
has four ‘ports’, which can be 
programmed with POKEs. 
Lines 1250 to 1350 set stan- 
dard Commodore port names 
and addresses, Fourteen bytes 
control each channel. The first 
a long word, the address of the 
wave data that will be played. 

The other values are 16 bit 
words. Next comes AUDOLEN, 
the length of the wave, in 
words, 1-65535, followed by 
AUDOPER which sets the time 
period between waves, in units 
of about 280 nanoseconds, 
The minimum period, or top 
speed, is about 130 units per 
byte played - about 28 thou- 
sand samples per second - as 
the data gets transmitted while 
the display is not busy, 

The next word controls the 
volume, from O to 64, so each 
channel has a 14 bit resolution, 
with 6 bits of volume control 
and eight bits of data, One 
word is unused; then come the 
registers for the next channel. 


The wave data must be 
stored in ‘chip memory’, acces- 
sible to the custom sound 
hardware, Most Amigas come 
with chip memory but you can 
add ‘fast memory later. If this is 
present QL tasks and heap can 
use fast memory, while the sys- 
tem occupies the first part of 
the chip memory. If ALCHP 
returns an address below two 
megabytes, Qdos is running in 
Chip memory and the space 
can be used. Otherwise we are 
in fast memory and need to 
look elsewhere. 

With Qdos running, my 3- 
megabyte Amiga has 2 
megabytes for Qdos code and 
data, and 800K of spare chip 
memory; the rest is used for 
disk track buffers, QL and 
Amiga screens, system code 
and variables, and the expan- 
sion ROM slot PEEK_L{SYS- 
BASE+1 24) finds the start of 
this unused space. Amiga Qdos 
‘roms’ like the SER and PAR 
device drivers sit at the other 
end. The BOOT program on 
the Amiga Qdos 3.2 support 
disk includes code to load 
toolkits into spare chip memory. 
If you use this, Mark J Swift rec- 
ommends CHIP-98688, 

SYSBASE, the first address of 
system variables, is always 
163840 on current Amiga 
Qdos systems. Ignore the last 
three lines of the listing which 
set up a Basic equivalent if you 
use the DIY Toolkit SYSBASE 
function. 

The hardware filter is con- 
trolled by an eight bit port, eco- 
nomically known to 
Commodore as PRA Unlike the 
16 bit ports, you can read as 
well as write to this, so the pro- 
gram uses PEEK to read the 
old value before setting or 
clearing bit 1 to turn the filter 
on or off. 


Two more 


Only two more registers need 
be explained, DMACON con- 
trols Direct Memory Access, 
and the bottom four bits of the 
word allow the sound channels 
access to chip memory. The 
low byte of ADKCON controls 
special sound effacts which 
combine channels, We POKE 


that to 255, to clear it without 
affecting the other bits, used by 
the disk system. 

How come 255 clears eight 
bits? The Amiga uses a neat 
scheme so you don't have to 
PEEK its word ports before you 
POKE individual bits. If bit 15 is 
set when you write to an Amiga 
word port, all the other set bits 
in the value you POKE get set 
in the register. Zero bits are 
unaffected. If bit 15 is zero, any 
set bits are cleared in the regis- 
ter. Again, zero bits have no 
effect. Thus you can whack the 
bit or bits you want without 
interfering with the others, 

POKE ADKCON with -32767 
or -32752 at line 1620 to hear 
Channel 1 modulating the vol- 
ume or period of Channel 2. It 
sounds weird unless Channel 
1 is much slower than Channel 
2, when you hear conventional 
analogue synth effects. 

The three DATA lines from 
1470 to 1490 describe square, 
sawtooth and rough sine 
waves. Eight bit sample values 
range from -128 to +127, and 
indicate the depth of the wave 
at successive points, Remove 
the REMark before the DATA 
you wish to use, and RUN the 
program to hear the new tim- 
bre. 

If you break in while the 
sound is playing, tyoe 
AUDIO_OFF 3 to stop the 
sound. Channels are numbered 
1,2, 4 and 8 and these values 
may be used in combination, 
so AUDIO_OFF 3 turns off 
channels 1 and 2, the two used 
by this program. AUDIO_ON 1 
turns the first back on again. 
The direct commands FILTER O 
and FILTER 1 switch the hard- 
ware filter off and on, control- 
ling the brightness of the Amiga 
power light into the bargain. 


Further work 


Try other wave DATA for a 
new tone or timbre. Longer pat- 
terns allow a more accurate 
sine pattern, like a flute without 
the initial breath sound, You 
can use samples up to 128K 
long. Lines 1560 and 1570 set 
the sample length to four 
wards. 

increase the 4 to 12, replace 


7 with 23 at the end of line 
1500, to read all three DATA 
lines, and increase the ALCHP 
on line 1380 to 24 bytes. Now 
you can play all three DATA 
patterns in one wave. This will 
make all the notes deeper 
unless you tweak the initial 
wavelength set at line 1120; 
experiment near the bottom 
right corner, to hear - and even 
count - the beats between 
notes. 

Mathematicians and psychol- 
ogists can investigate the 
errors in chords for different 
scales. What is the next best 
number of divisions to set to 
get a mathematically perfect 
pentatonic scale? How does 
the wave pattern influence per- 
ceived pitch? 

Hf you're more practically 
minded, why not write a 
SuperBasic procedure to emu- 
late QL BEEP? Start with just 
the first two parameters, and go 
on to the others when the pitch 
and duration match your QL 
You could use UNSET (from 
DIY Toolkit Volume Q) to 
check the number of parame- 
ters, and the Timer routines 
from Volume H for processor- 
independent timing. The QL 
waveform is a rough square 
wave, but you can probably find 
something more pleasant, if 
less accurate! 


Action 


SuperL2sic 
in 
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Easy with 


Easel - 


part 4 


Henry Orlowski examines the powerful design features inside Easel. 


April's issue we 


finished our 
graph design 
and examined 


the different formats in which it 
could be displayed. This time we 
will look at the fine tuning we 
can employ to change almost 
every aspect of the graph to put 
a personal stamp on it 

Load up Easel and the graphs 
you saved previously, Make 
‘poys’ the current figures using 
the View or Olddata command if 
itis not the current set dis- 
played. 

The first bit of fine-tuning we 
will look at is to make certain 
parts of the graph stand out 
Change to format O, 1 or 2, the 
vertical bars. Looking at the bars 
it will suddenly strike you that it 
is notable that so many boys 
liked a cooked meal rather than, 
say, a quick takeaway, such that 
it was worthy of highlighting this 
result To do this, use the H for 
Highlight command. Then press 
the V for value option and select 
the cell whose value wants high- 
lighting, (You will have noticed 
that your other option is to 
select to highlight all negative 
values, but this is not applicable 
in this case) Next you are given 
the option to select a defined 
highlighted bar or you can even 
design your own (more on 
designing your own bars later 
on), Try a few different selections 
and see which is the best for 
the job. 

Now change to format 7 for 
the pie chart option. You will see 
what you would have got if you 
had carried out the same 
sequence of operations. In this 
case the segment is highlighted 
by detaching itself from the 
chart 


Making Changes 


Now let's return to one of the 
vertical bar formats. You might 
consider that you dont like the 
look of the bars you've got You 
can change the colour and 
even give them a border. 

Choose C for Change, then B 
for Bar. Easel then asks you for 
the number of the bar you want 
to change to. Of course, you 
won't know what corresponds 
to what, so instead of putting in 
a number in response, just 
press Enter at the ? prompt You 
will see displayed 18 different 
numbered bar types on screen 
for you to choose from. Use the 
cursor keys to move between 
bars, then use Enter to make 
your selection. Try a few out 

If you can't find one that you 
like, you can actually design 
your own. To do this select the ? 
bar option to put yourself into 
bar design mode, You now have 
a series of operations you can 
move between using the up and 
down cursor keys. Pressing 
Enter while on an operation 
allows you to make changes 
within that operation. The first is 
the bar colour. Use the cursor 
keys to move between the four 
possible options, and note how 
the diagram on the right 
changes to reflect the design 
choices you are making (of 
course, it helps to have a colour 
screen). 

Then you can select a border 
colour for your bar. This is the 
border around the bar itself, and 
again you have a choice of four. 
tt might be best to examine the 
next option first, however; this is 
the border thickness and you 
should be aware that if your bar 
has no border then it means 
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that the border thickness is in 
fact zero, so changing the bor- 
der colour will not make any dif- 
ference, However, entering a 
border width will make any bor- 
der colour come into being. The 
border width is expressed as a 


Heal Preferences 


Takeaway 
4 


number between 1 and 100. 
Don't worry what its unit is, just 
try out a few different values and 
see what you get Once you are 
happy with your design combi- 
nation press the ‘satisfied’ option 
and all will be displayed. 


Tweaking text 


Moving further on, you might 
decide that the text style is not to 


your liking and you want it 
changed to make some text 
stand, This does affect the ‘title’ 
so enter some text like ‘School 
Market Research Project’ and 
position it where you like. To 
make changes to this text, use C 


Sanduich 
3 


for Change followed by T for 
Text A number of options are 
then presented to you in the 
same way as with the bar 
design operation, 

The first is the text colour, fol 
lowed by the background paper 
colour. This is not the colour of 
the whole graph but the area 
immediately behind the text in 
question. The next option is to 
choose a transparent back- 


Fill colour 


command? Change to BAR ? 
“ornat @ Rap BAR 
Current Home gerds 


ground paper, in other words, 
the same as the graph paper 
background, If you want this 
option you will notice that it tog- 
gles between on and off every 
time you select it If on, the back- 
ground paper colour is ignored. 
Lastly, you can select a text 
direction which toggles between 
vertical and horizontal each time. 
Why not choose ‘vertical’ to 
make it stand out from the title of 
the graph? When happy with 
your selection press ‘satisfied’. If 
you dont like what you see, try 
again. 

There are still a number of 
additional options available to us 
to change the appearance of 
our graph further, The major 
area of the graph is usually the 
graph paper itself, the area 
which is currently made up of 
the background grid on a paper 
colour you can see on the dis- 
play, 

To change this use C for 
Change followed by G for 
Graph, You will see a display of 
seven graph styles for you to 
make a preference, Alternatively 
you can design your own, SO 
why don't you do so, Accept the 
? to gat into design mode. You 
navigate between the options 
and make your selections as 
before with the bar and text 
change operations so | won't 
repeat it Suffice to say that you 
now have the ability to design 
the paper colour and the grid 
colour by following the indica- 
‘ions displayed to you. 
Experiment a tittle. It's the best 
way to grasp it If you don't like 
your design when you see it in 
all tts glory then try again until 
you're happy. 


Axis and label 


We're not finished yet. You can 


also change the style of your 
graph’s axis design. To do so 
you must use the Change com- 
mand as before, this time with A 
for Axis. Try it and select one 
frarn the 10 styles shown. Or, 
design your own. The design 
option lets you come up with 
your own combination of axis 
and label colours, axis limits (the 
low and high values of your axis) 
or aven whether you want the 
axis lines drawn or not As 
before try a few combinations 


and see how they look 

Lets now look at a further 
option. Change to format 3 or 
4 depending on your version 
of the program, which is the 
line graph format Line graphs 
are best for displaying trends, 
but we are experimenting. 
What we will do now is 
change the style of the line. A 
number of possibilities are 
available, Use the Change 
command again but this time 
select L for Line. You can now 
give a line style number, which 
you won't be able to do 
because you are not familiar 
with the options, or accept the “?. 
This gives you a display of 16 
possibles to choose from. Or 
you can design your own, Let's 
design our own, Move to the 
and Enter. 

You are now presented with a 
number of design options for 
you ta consider, Firstly you have 
the choice of four line colours 
for you to select one that looks 
the best Then you can choose 
whether to display a symbol or 
not The symbol means a small 
marker to denote the position 
of each point on the line, 
Thirdly, you can choose the 
colour of the symbol, out of 
four possibilities, and then you 
can have your line ‘filled’ if 
required. This option gives you 
a range of mountains rather 
than just a line and serves to 
give a sense of power or 
importance to the values it 
represents, If, for example, you 
are displaying two sets of fig- 
ures, one of which is a set of 
actual values while the other is 
the minimum acceptable below 
which you must not go, then our 
mountain range filled line could 
be used to represent the critical 
base, And finally you can 
choose the thickness of the line 
itself within a range of 0 to 100. 
Again the best thing to do is to 
experiment and see what com- 
binations you can come up with. 


Shades of grey 


| think you will agree that the 
sheer scape for customising 
your graphs is limited only by 
your imagination. As always you 
should bear in mind that what 
you end up with an your moni- 
tor will not be accurately repro- 


HELP 


F2 


SELECTION 


Moye the box cursor vith the + + 
keys and press ENTER. For a 
new design select the last (7). 


CONMANDS 


F. 
XCHANGE 
Fi 


EASEL Burs 


Your Bars 


conmand> Change to BAR ? 
Format @ Rep BAR 3 
Current Name girls 


duced when you print it out A 
mono printer, as most of us 
have, will only produce shades 
of grey to represent different 
colours, and even a colour print- 
er may have difficulty in differen- 
tiating all the different colours 
you wish to have produced. The 
important thing is to produce 
something that has your own 
personal stamp on it, and that 


you should now be familiar with 
the enormous range of func- 
tions that Easel can offer to cre- 
ate new and original offerings 
for a range of potential uses. 

Always remember to S (Save) 
your masterpieces for future call 
up so that you can retrieve them 
at any time. Once you've got 
your graphs safely tucked up in 
their disk or microdrive file, and 
you want to create a new graph 
of some sort, then you can 
either K {Kill} or Z (Zap) your 
existing sets of figures held in 
memory. 


Kill and Zap 


lf you use K for Kill it deletes 
all your data from one or more 


Task graphs 
7O6K Memory 


sets of figures, which you speci- 
fy separated by commas, yet 
retains all your settings, includ- 
ing all your design work. So if, 
for example, you conduct a simi- 
lar survey at another school, you 
can just enter the new results 
into the same basic graph set- 
up. 

Zap |s different because it gets 
you back more or less to the 


original basic graph layout you 
are presented with when you 
first load up Easel, This includes 
the original horizontal axis labels, 
Jan to Dec. 

If you want to leave Easel alto- 
gether for now then use the Q 
for Quit option. 

Finally, | would like to thank 
you for following this series of 
articles. | trust you have found it 
enjoyable and informative. My 
aim was to make you aware of 
Easels potential for everyday 
applications in addition to the 
more obvious business ones, 
and if ve made you stop to 
think about ita little then 1 have 
been on ihe right road. Stay with 
it a little longer - its an opportu- 
nity not to be missed, 


SINCLAIR QL WORLD 37 


Data- 
DESIGN | 5 


Wolfgang Lenerz has been using and commenting on the new DataDesign. 


The database market 


for the QL isn't really saturated. 
Apart from the ubiquitous 
Archive, the only serious 
contender was Flashback, which 
had the advantage of being 
faster, but could not be 
programmed, and its report 
generator left much to be 
desired. Now’ there is 
DataDesign, a database 
management system for the QL 
programmable in 'C’, Basic and 
Assembler. 

Perhaps | should set out right 
from the start that | have been 
slightly "involved" in this program 
as a beta tester. Having said 
that, | have no connection to 
Progs, the authors, other than 
being a (difficult to satisfy.) user 
of their program. It is probably 
due to the fact that | didn't stop 
bombarding them with 
suggestions that they asked me 
to beta-test version 3 of their 
programs. On the other hand, | 
can witness their willingness to 
listan to users, and make 
reasonable amendments/ 
additions. Progs' after-sales 
service leaves nothing to desire! 
| do admit, however, that | am 
really taken by this software, 
which | find very powerful. 


More friendly 


DataDesign 3 is (you might 
have guessed) a successor to 
DataDesign 2, a moderately 
successful database 
management system (DBMS) on 
the QL To exist next to Archive, 
which comes free with every QL 
a DBMS must be faster, more 
powerful and more friendly than 


its eternal rival. | find that 
DataDesign is. The interesting 
thing about DataDesign is that it 
comes in three parts: first, there 
is the database “engine”, the 
part that actually handles all the 
data. This is the most important 
part of the system. Second, there 
is a badly-named ‘Main 
program’, which is actually a 
front end to the engine, allowing 
easy access to the engine and 
the data. Most users who are 
not programmers will use this 
front end to access the 
database. Finally, there is the 
“Application Programmers 
Interface” (API). This is the 
description of how you can 
access the database from within 
your own programs, enabling 
you to program the engine 
directly. 

This means that DataDesign 
will be suitable at the same time 
for those who want a simple, no- 
hassle, cardfile-type database (a 
la Flashback), and for those who 
want to write fully-fledged 
database applications. Also, as 
both are sold separately, you 
can buy only that part which you 
really need, | shall concentrate 
first of all on the engine itself, 
then on the front end and finally 
on the API. 


The engine 


The engine is the very heart of 
the DBMS. It is through this that 
you access the data, add to it, 
delete from it, filter or sort it, etc. It 
is also the engine which 
determines whether a database 
is fast, how many records can 
be used, how the database is 


organised and so on, The 
distinction between the engine 
and the “front ends” exists in 
nearly every database (even in 
Archive). DataDesign is special 
in that the distinction between 
the engine and the various front 
ends is made quite clear. The 
DataDesign engine has two 
fundamentally different ways of 
handling files: files can be disk- 
based, or memory-based. The 
disk-based approach is that 
used by Archive: all the data, 
except for a few records, 
remains on the disk and is 
loaded only for displaying (or 
selecting, sorting, etc). The other 
way of handling data, which can 
also be implemented in 
DataDesign, is to load all 
records into memory right away 
and keep it there until one quits 
the program. 

Both methods have their 
advantages and disadvantages: 
leaving the records on the disk 
will slow down access to the 
data, as it will have to read from 
the disk each time it is to be 
accessed, Having the data in 
memory makes access to it is 
so much faster. On the other 
hand, in theory a disk-based 
database is safer. if the 
computer crashes, only one 
record should be corrupted, that 
currently being updated and 
which hasn't been saved yet. In 
a memory-based database, 
unless the data is explicitly 
saved after each modification, it 
will all disappear if the computer 
crashes (as has been known to 
happen to the QL!), In this, 
Archive is not typical, because it 
has both disadvantages: it is 
disk-based, and slow, but if the 
computer crashes with the file 


still open, you still lose all your 
data. They got it wrong there! 

This does not happen with a 
disk-based file in DataDesign. 
where at the utmost you lose 
only one record (the one in 
memory, or the one being 
written out to the disk). 
DataDesign is noticeably faster 
than Archive even in disk-based 
mode. 


Memory size 


The DataDesign engine also 
accepts that a file can be 
memory-based, increasing yet 
again the speed of access. Of 
course, when a file is memory- 
based, all data is held in 
memory, so that, with a large 
database (over 700 KB, as are 
some of mine), one might need 
at least a Gold Card, 

Like every other database, 
DataDesign is organised in 
records, each record containing 
a given number of fields. 
According to the documentation, 
DataDesign has no limit on the 
number of records it can handle, 
except for memory: in a 
memory-based database, the 
number of records will depend 
directly on the amount of data 
contained in each record. For a 
disk-based file, each record 
takes 18 bytes of memory at 
least (this can be more, if 
different indexes are used; see 
below), Here the power of 
DataDesign becomes apparent, 
as it is possible to switch 
between disk-based and 
memory-based operations at 
any time! If a memory-based file 
becomes too large, one can 


' another. In 


make it disk-based, and 


continue working on it. 


dif'AGH ABH GELP ToS 
fields per record. That should be 
enough for most of us. If not, it is 
possible to sub-divide each field 
into lines and, of course, access 
each line independently. 
Moreover, the lines of the fields 
have no imposed maximum 
length, they are as large as the 
data put Into them. This, 
combined with the fact that 
DataDesign accepts “raw” fields 
(which have no deteremined 
type and can be used, for 
example, for images) means that 
DataDesign is a free-formt 
database, At the same time, the 
DataDesign engine allows you, 
should you so wish, to give a 
determined type to each field - 
the allowed types are: raw 
(anything), string, integer (2 
bytes), long word (4 bytes) and 
IEEE double (8 bytes), 


Fresh fields! 


Concerning the fields, a 
significant difference with 
Archive can be seen: it is 
possible, at any time, to add (or 
delete) a field! This is not 
possible with Archive where one 
has to create a new database 
containing all of the old fields as 
well as the new one, and then 
copy all the data across, 

The DataDesign engine can 
access an unlimited number of 
fles at the same time, so there 
can be an unlimited number of 


| files ‘open’ and, of course, data 


can be passed from one file to 
that sense, 
DataDesign is a true relational 
database, At the same time, an 
unlimited number of jobs can 
call upon the DataDesign 
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LONG field 


fields 

fieldl@ 
fieldil 
field? 
fieldl3 
fieldi4 


fie 
fie 


Ids 


tieldt? 
fieldis 


engine simuitaneously - two (or 
more) jobs can even work upon 
the same database at the same 
time! As this can even take 
place over a network (1), 
DataDesign is a true multi-user 
database. Of course, a 
sophisticated 'record-locking' 
system has been implemented 
for this, to avoid having one 
job/user accessing a record 
which is currently being 
modified by another job/user, 
DataDesign is quite fast when 
ordering a file, or filtering it 
(select in Archive). Moreover, it is 
the only QL DBMS | know of that 
implements indexes. An index is 
nothing more than a way of 
describing how a database 
should be ordered/selected. 
When one orders a file in 
Archive in a certain way, an 
index of where every record 
should be in that order is built 
up. The same is true in 
DataDesign. However, if one 
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| Begin/first 
' End/last 
 Search.. 
 Replace.. 


| Filter file.. 
Sort file.. 
New field.. 
' Erase field.. 
| Stuff record z.. 


Duplicate record 
Undo/Truncate 
Delete record 
Clear all mark 
New record 

Set MEMO field.. 
Clear field.. 
View file... 

Quit program 
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figure 3: The cammend menu. Other cammands are avaliable in the Files 


menu 


figure 1: The main program - field names on the left, contents on the rght 
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figure 2: The filter manu - upto 10 filter levels can be set 


needs a new order in Archive, 
the old one is destroyed, and to 
get it back one must again re- 
order the file. This is not so in 
DataDesign, where one can 
keep each index (and even save 
it onto disk) and access the 
database through these indexes 
at any time, It thus becomes 
possible to have several indexes 
at once in the machine, allowing 
accesses to the data according 
to varying sort and filter criteria. 

As can be seen from the 
above, the DataDesign engine is 
very powerful. It is fast, too. 


The front end 


To take advantage of the 
DataDesign engine, one must 
have a front end, either a 


program built by yourself, or the 
“main program” supplied by 
Progs. This front end to the 
engine presents itself as a 
pointer-driven program (see 
figure one). Anybody who uses 
software under the pointer 
environment will be immediately 
familiar with the software and its 
menu system, 

The “main program’, as it is 
also called, is designed to be as 
simple as possible. It hides most 
of the complexities of the 
DataDesign engine, at the cost 
of not being able to use all of its 
features. It turns the Database 
engine into a simple flatfile 
DBMS - one file at a time only, 
which generally is sufficient for 
most users anyway, This again 
is an advantage over Archive 


which is really quite unusable 
unless one writes at least some 
procedures to drive it (on the 
other hand, public domain, 
purpose-written Archive 
programs abound). 

The main program allows 
easy access to data, one file ata 
time, filtering and sorting 
operations are quite intuitive 
(see figure two) and most 
operations can be handled 
directly with the pointer, 
although keyboard shortcuts are 
available. 

There is not much else to be 
said about the main program, 
which admittedly uses the 
engine at less than half its 
power, On the other hand, it will 
satisfy most users (see figure 
three, some of the commands 
available) - and those who need 
more are probably those who 
would program the engine 
directly anyway. 


Programming 


{t is possible to use the 
engine - and access the data - 
directly from your own programs. 
This is done either via new 


Basic keywords, if you program 
in Basic (these new keywords 
are, of course, supplied), or 
through © functions/library calls 
(also supplied) or through 
assembler routines (all 
described in the manual). This is 
called the API (application 
programmers interface). 

This means that DataDesign 
does not have its own 
programming language like 
Archive - but it does allow you 
to program the database in 
Basic, C, or Assembler (I will 
use Basic from now on, as 
most readers will be familiar 
with that). | must say that | find 
the power of this astonishing, 
as | can have the speed and 
flexibility of Basic (especially 
compared with the Archive 
language) combined with all 
necessary extensions to access 
a database. Moreover, as the 
engine is entirely  pro- 
grammable, it is perfectly 
possible to write your own front 
end. Of course, applications 
written in Basic with the new 
keywords can also be 
compiled. 

For the technically minded, 
the engine itself is implemented 
as an extension “thing”. When 


programming in assembler, 
standard calls are made to use 
this thing, and all parameters 
are well explained in the 
manual. 

For those programming in C, 
a library of function calls Is 
supplied, opening all 
possibilities of the engine. It is 
thus very easy to incorporate all 
calls to the engine into one's 
own programs. 


Keywords 


The Basic programmer has 
not been forgotten, of course. An 
important number of new 
keywords are added to Basic, 
through which all functions of 
the engine can be accessed. 
Programming a database never 
is - and never will be - easy and 
DataDesign is no exception, but 
at least here one is in a familiar 
programming environment. 

Of course, programming the 
engine needn't be very 
extensive. It is a relatively simple 
affair to write a (small!) program 
for, say, a report generator. An 
advantage of DataDesign is that 
those who do not feel the need 


to program their engine, do not 
have to pay for this possibility. 
Indeed, DataDesign comes in 
two packages; the engine and 
main program combination on 
the one hand, and the API 
(without the engine), on the other 
hand. So you need not buy the 
API if you do not want to. Of 
course, those who want the API 
will need to buy both. 

On a final note, DataDesign 
comes with the necessary tools 
to convert your old databases 
into the format used by itself. 

In summary, | definitely give 
DataDesign a ‘thumbs up’. 
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‘Beginners’ 


Machine Code 


Part 4 


In part 4, Alan Bridewell deals with repeating functions. 


parts 2 and 3 of 


this series, we pro- 
duced loops of 
code which were 


designed to be repeated a fixed 
number of times. So we used a 
foop counter’ to count how may 
more times it had to repeat 
before it had finished. 

But there are many situations 
where you cannot know, in 
advance of running the pro- 
gram, just how many times you 
want to rapeat the loop. What 
you want is for the loop to keep 
repeating until a certain situation 
occurs which tells you it has 
done enough. For example, if 
you are loading a document into 
a word processor, you want the 
program to keep loading until it 
reaches the end of the docu- 
ment, without it being told first 
exactly how long the document 
actually is. 


Status register 


The microprocessor in the QL 
has a special register for this 
purpose called the ‘status regis- 
ter’. We have already used this 
register in the DBRA instruction, 
but it has been used in such an 
automatic and controlled way 
we did not actually need to 
mention it But to find out if a 
particular condition has 
occurred, we need to find out 
what Is actually in the register, 
so we need to know something 
about it 

The most important point 
about this register, which ts 
completely different from all the 
others, is that the individual dig- 
its it stores are NOT used as 
one number, but are used to 
store quite separate bits of infor- 
mation. These digits (normally 
called ‘flags} become ‘set (equal 


to 1) or ‘clear’ (equal to 0) 
depending on the result of cer- 
tain things the program does. 

There are five flags in the reg- 
ister which we need to concern 
ourselves with, and understand 
what it means when they 
become ‘set’ or ‘clear’. 


The 'Z' or ‘zero’ flag is set if an 
instruction results in a zero 
being produced. This will hap- 
pen, for example, when a nurm- 
ber is subtracted from an equal 
number. 

The 'N' or ‘negative’ flag is set if 
an instruction results in a nega- 
tive number being produced, for 
example, subtracting one num- 
ber from a smaller number. 

The 'C’' or ‘carry flag is set if an 
instruction results in a number 
too big for the register, so a 


iisting t 


‘carry’ to the next digit is needed. 
This can result from addition or 
multiplication. 

The ‘V or ‘overflow flag is set if 
the instruction cannot be carried 
out with the numbers given to it, 
for axample, if we try to divide by 
Zero. 

The ‘X' or ‘extended flag is set 
or cleared when certain types of 
add, subtract, shift or rotate 
instructions move data in or out 
of it This is definitely not begin- 
ners stuff, so we shall leave it for 
the time being. 


A full explanation of what does 
or does not alter these flags 
really requires a programmer's 
reference manual, but in general 
terms it is fair to say that if an 
instruction MIGHT cause a flag 
io set, then ii WILL set if the con- 


dition occurs and it WILL clear if 
the condition does not occur, If 
the instruction could not pro- 
duce the condition, it will leave 
the flag unchanged. 


Branching 


There are different ways to 
use the information stored in the 
status register, but the most 
common, and the one we shall 
look at, is by using ‘conditional 
branching’. There are actually 
14 of these conditional branch- 
ing instructions, each of which 
will cause the program to 
branch to a specified address if 
a particular combination of con- 
ditions occurs. Some of these 
combinations are quite compli- 
cated involving ‘AND' and ‘OR’. 
We shall deal with two simple, 
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HOLDS 
HOLDS 
HOLDS 


HOLDS 
HOLDS 
HOLDS 


WORD TO PUT INTO SCREEN ADDRESSES 
SCREEN WORD ROW NUMBER (UP TO $FF) 
SCREEN WORD ROW INCREMENT VALUE (UP TD #FF) 

SCREEN WORD COLUMN NUMBER (EVEN NO, UP TO $36) 

SCREEN WORD COLUMN INCREMENT NUMBER (EVEN NO, UP TO $3E) 
CURRENT SCREEN ADDRESS RELATIVE TO #20000 

CURRENT ABSOLUTE SCREEN ADDRESS 


Di, D2, DS, D4, DS ARE TO BE SET BY THE ‘CALL’ COMMAND FROM SUPERBASIC 


3 
5 
3 
3 
3 
; 
i 
3 HOLDS 
$ 
3 
j 
3 
5 
5 


«LOOP 
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#20000, AO 
#0,D6 
D3,D2 
#$FF ,D2 
EXIT 
#30 ,D2 
EXIT 
D5,D4 
#$3F,D4 
EXIT 
#40,D4 
EXIT 
D2,D6 
#80 ,D& 
D4,D6 
D4,Dé 
D&,A0 
Di, (ao) 
Loop 
#50,D0 


yes, 


YES, 


YES, 


YES, 
ROW NO, 
ROW NO. 


NO ERROR 


RESET SCREEN ADDRESS 

RESET RELATIVE SCREEN ADDRESS 
INCREMENT ROW 

ARE WE PASSED LAST ROW? 

THEN EXIT LOOP 

ARE WE PASSED FIRST ROW? 
THEN EXIT LOOP 

INCREMENT COLUMN 

ARE WE PASSED LAST COLUMN? 
THEN EXIT LOOP 

ARE WE PASSED FIRST COLUMN? 
THEN EXIT LOOP 

IN Dé 

X BYTES PER ROW 

ADD COLUMN 

AND AGAIN FOR WORD LENGTH DATA 
ADD TO SCREEN ADDRESS 

LOAD WORD INTO SCREEN ADDRESS 


RETURN TO SUPERBASIC 


| obvious, and useful ones. 


‘BMI’ stands for ‘branch if 
minus’, and branches if the N 
flag is set, indicating that a 
minus number has been pro- 
duced. 

'‘BPL' stands for ‘branch if plus, 
and branches if the N flag is 
clear, indicating that a minus 


number has not been produced. 


Although we shall not be 
using them here, | will mention 
two others, which are also very 
useful. 

‘BEG’ stands for ‘branch if 
equal, and branches if the Z flag 
is set, indicating that a zero has 
been produced. 

‘BNE’ stands for ‘branch if not 
equal’, and branches if the Z flag 
is clear, indicating that a zero 
has not been produced. 


Listing 2 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 


z = RESPR (312) 


REPeat loop 
CLS#3 

INPUT#3, 
INPUT#S, 
INPUT#S, 
INPUT#S, 
INPUT#S, 
CLS#3 


PAUSE -1 
END REPeat loop 


You might be wondering what 
being equal has to do with the Z 
flag, The answer is quite simply 
in the most common way of 
using the status register, 
Although most instructions will 
alter flags in the register, and we 
can use them at almost any 
time, what we most frequently 
do is use instructions whose 
whole purpose is to alter the 
flags to give information. These 
are the ‘compare’ Instructions, 
which do just that We shall look 
at one of these in detail, to see 
exactly what it does. 

'CMPI' stands for ‘compare 
with immediate data’. Immediate 
data means that the actual num- 
ber used for comparison is in 
the instruction, not in some reg- 
ister Or memory location from 
where it has to be fetched first 
What the instruction does is to 


“STARTING ROW? (0 to 255) 
“INCREMENT ROW BY? (0 to 255) 
"STARTING COLUMN? (O to 43) 
“INCREMENT COLUMN BY? (0 to 463) “,c_inc% 
"WORD TO PUT INTO SCREEN ADDRESSES", word% 


subtract the immediate data 
from the data we are comparing 
it with, and alters the flags 
according to the result For 
example, consider the instruc- 
tion 


CMPIW #SFF.D2 


Remember the hash (#} tells 
us we have an actual number, 
not an address, and the S 
means it's a hexadecimal num- 
ber. So the instruction will sub- 
tract #SFF from the contents of 
data register D2 to see what 
happens. (The result of this sub- 
traction is not stored, and D2 
remains unaltered. The only 
affect is on the flags) 


lf D2 contains a number less 
than #$FF, then we get a minus 
number. This will set the N flag 


LBYTES flp2_LISTING1_code,z 
OPEN#3 ,con_512x254a0x0 


* rows 


", col% 


CALL z, word%, rows, r_inc%, col%, c_inc%,0,0 


and clear the others. 

lf D2 contains a number 
greater than #$FF, then we get 
a plus number. This will clear all 
the flags. 

lf D2 contains exactly #SFF, 
then we get zero. This will set 
the Z flag and clear the others. 


We can now see what being 
equal has to do with the Z flag. If 
we compare two numbers by 
subtraction, we get zero if they 
are equal (so the Z flag is set), 
but we get either a plus or a 
minus number if they are nat 
equal (so the Z flag is cleared), 


Compare and 
branch 


This use of ‘compare’ and 
‘conditional branching’ instruc- 


* P_incd 


tions together is a very powerful 
way of controlling what a pro- 
gram does, and is well worth a 
lot of effort to master. 

Before we get round to actual- 
ly using these instructions, | 
would like to introduce the arith- 
metical instructions. 

‘ADD’ means simply that It has 
a few variations like most 
instructions, but the most impor- 
tant point is that we can add 
minus numbers as well, result- 
ing in a smaller number. ‘SUB’ 
for ‘subtract’ is just as easy. 

There are two forms of the 
multiply and divide instructions, 
called ‘signed’ and ‘unsigned’, 
Microprocessors have a special 
way of dealing with whether a 
number is plus or minus, which 
we shall not deal with here. 
When this special way is being 
used the numbers are said to 
be ‘signed’. Our 
last two pro- 
grams have used 
signed numbers, 
but because our 
assembler can 
deal with them 
automatically, we 
have not had to 
mention the fact. 
But signed num- 
bers need spe- 
cial instructions, 
‘MULS' and 'DIVS' 
standing for 
signed multiplica- 
tion and division. 

lf we ignore 
signs, and treat all numbers as 
positive, we can use 'MULU' and 
DIVU', standing for unsigned 
multiplication and division. 
MULU will multiply two word 
sized numbers to give a long 
word sized number. 


Blob time 


To illustrate this new material, 
we shall put together a routine 
to print rows of blobs on the 
screen. They can start anywhere 
on the screen, can go in any 
direction, and will stop at the 
edge of the screen, But before 
we can do this, we need to 
know a litle bk more about how 
the screen ram is converted ta 
dots on the screen. 

The information for a row of 
pixels is held in 128 consecu- 


tive bytes. Each word (two bytes) 
contains the information for 
either four pixels in 8 colour 
mode, or eight pixels in four 
colour mode, Exactly how the 
different pixels are dealt with 
within the word we shall leave 
for the present We shall simply 
regard each word as dealing 
with a long, flat, multicoloured 
blob, which is actually a short 
row of pixels. There are 64 such 
blobs in each row, with 256 
rows in a screen. 

Clearly, each time we increase 
the screen address by two, we 
move right to the next blob, To 
move to the next blob down, we 
have to increase the screen 
address by 128 (which is #$80 
in hexadecimal). This gives us a 
formula for calculating the 
address of any particular blob 
on the screen, as follows. 


1, Multiply the row number 
(from the top) by #$80. This gets 
us to the correct row. 

2. Add twice the column num- 
ber (from the left). This gets us to 
the correct column. It has to be 
twice the column number 
because each blob is a word (or 
two bytes) long. 

3. Add this to the address of 
the start of the screen RAM 
(#S20000). 

For example, Suppose we 
want the address of the blob 
which is two rows from the top 
and three columns from the left 
The formula gives 


(2 x #$80) + 6 + #520000 - 
#$20106 


Don't worry if you can't do the 
hexadecimal calculation yourself 
- the microprocessor will do it 
for you as long as you give it the 
correct numbers! 


Using CALL 


One last point before we look 
at the actual routine. Clearly it 
would be very clumsy if we had 
to rewrite the program every 
time we wanted to draw a differ- 
ent line, The best thing is to put 
the data for the line into some 
registers, then access the data 
to draw the line we want. The 
SuperBasic command CALL 
enables us to do this. 

Up to now we have used the 


SINCLAIR QL WORLD 43 


CALL command with just one 
parameter, the address we 
want to start the machine code 
from, But CALL will take up to 
13 extra parameters, and these 


will be loaded consecutively into Listing 3 
the registers D1 to D7 then AO Sot cea aac is hae dpi atta oe 
to A5, before starting from the ar inclair ior : v ; 
address given. This is just what oan igen by Marcus Jeffery & Simon N Goodwin 
we need fo load our data into 130 CLS: RESTORE :READ spacesstart=RESPR (space) 
registers before drawing the 140 PRINT “Loading Hex...":HEX_LOAD start 
line. 150 INPUT "Save to file..." ;f% 

Listing one shows our rou- 160 SBYTES #%,start,byte:STOP 
. =a 170 : 
tine. It woutd st aigeet be a 190 DEFine FuNction DECIMAL (x) 
able to follow the listing while 190 RETurn CODE (h# (x) )-48-7# (hs (x) >"9") 
reading through the next bit, so 200 END DEFine DECIMAL 
that it is clear what part of the 210 : 
listing each point refers to, DEFine PROCedure HEX_LOAD(start) 

: byte=0: checksum=0 

As you can see, it expects Y 
certain registers to be loaded teas digits 
with data before it starts, and IF h$="*"1EXIT load _hex_digits 
this will be done from IF LEN(h®) MOD 2 
SuperBasic with the CALL com- PRINT “Odd number of hex digits ins “3;hs 
mand as indicated. Address STOP 
register AO will be used to hold END IF 


FOR b#1 TO LEN(h#) STEP 2 
hb=DECIMAL (b) :1b=DECIMAL (b+1) 


the ram address of the blob to 


be drawn, so the loop begins by IF -hb<O OR hb>15 OR 1b<O OR 1b>15 
resetting this to #$20000, PRINT “Illegal hex digit ini "jh%:8TOP 
which is the start of the screen END IF 
ram, Data register D6 will be POKE start+byte, 146#hb+lb 
used to calculate the relative checksum=checksum+1ié*#hb+1b 
byte=bytetrli 
screen address of the blob, so END FOR b 
we Clear it to zero at the start of END REPeat load_hex_digits 
each loop. READ check 
D2 holds the screen row of IF check< >checksum 
the blob and D3 holds the row enon "Checksum incorrect. Recheck data. ":STOP 
increment value (ow many PRINT “Checksum correct. Data entered at: "sstart 
rows between each blob). So END DEFine HEX_LOAD 
we increase (or decrease) the : 
number in D2 by the number in REMark Space requirements for the machine code 
D3. Before we go any further, DATA 64 
} j & 
= He ee ee DATA “207C00020000": REMark .LOOP #%20000 , AO 
ieteblaon DATA “7COO": REMark #$00,D6 
screen. By comparing D2 with DATA "D443": REMark D3,D2 
#$FF (255 in decimal) we can DATA “OC4200FF "1 REMar k #$FF ,D2 
see if we are off the bottom of DATA “SA00002C": REMark EXIT 
the screen. If the N flag is not DATA “0C420000": REMark #400, D2 
set, then we are off the bottom, DATA "6B000024"1 REMark EXIT 
PL instruction branch- DATA "DEAS": RENark DS, D4 
and the BPL i wot : DATA "“OC44003F ":REMark #S3F ,D4 
es Out of the loop. Similarly, if we DATA "SA00001A": REMar k ExIT 
compare D2 with #00, the N DATA "00440000": REMark #$00,D4 
flag set (meaning a minus result) DATA “&SB000012":REMark EXIT 
would cause the BM! instruction pe seretnn, cake . Se 
‘ "8 jar #$80,D4 
to branch out of the loop. DATA “DC44"sREMark . pa.Da 
In exactly the same way, we DATA "DC44"1REMark pape 
can increment the column by DATA “"DOC6é"1REMark D&,A0 
increasing (or decreasing) the DATA “3081":REMark D1, <Ao) 
number in D4 by the number in DATA “S0C4"sREMark Loor 
D5. By comparing D4 with DATA "7000" 8 REMark #$00,D0 
#$F, a BPL will branch out of DATA "4E75"rREMark 


DATA “#", "4658" 


the loop if we are off the right of 
the screen, and by comparing 
D4 with #$00, a BMI will branch 
out of the loop if we are off the 
left of the screen. 


44 SINCLAIR QL WORLD 


Sa a 


\ 
| 


qh 
: 


Blob control 


By using these compare and 
branch conditionally instructions, 
we have arranged for the rou- 
tine to leave the loop as soon as 
our blob goes off any edge of 
the screen. 

ff our blab is still on the 
screen, we now have to calcu- 
late its address, using the formu- 
la, as follows: 


1. Add the new row number in 
D2 to DB, 

2, Multiply D6 by #580 to get 
to the right row, 

3, Add the new column num- 
ber in D4 to D6, but do it twice, 
because each blob is a word (2 
bytes} long. 


D6 will now hald the address 
of the blob relative to the screen 
start address (#S20000}. To get 
the absolute screen address of 
the blob into AO, we add D6 to 
the #520000 already.in AO. We 
can now print the blob on the 
screen by moving the blob data, 
held in D1 into the address held 
in AO. We end the loop with a 


BRA instruction to start the loop 
over again. 

When we finally leave the loap 
because the biob has wandered 
off the screen, we must tidy up 
by putting zero in DO to make 
sure we get no error message, 
and then return to SuperBasic 
with RTS. 

Listing two shows a 
SuperBasic program to load 
and run the routine. It is 
designed as an endlessly 
repeating loop to input tne para- 
meters from the keyboard to 
see what they produce on the 
screen. Once you have got it 
working, and feel you under- 
stand what is going on, it would 
be far more interesting to 
rewrite it to draw lines automali 
cally, either at random, or in a 
fixed pattern. If you do not CLS 
between each CALL, you could 
draw patterns, boxes, etc. By 
using CLS, and arranging for 
the parameters to change slow- 
ly and smoothly, you could 
make the line appear to move 
smoothly round the screen. 
Adding a random colour 
change to this, could produce 
some interesting effects. In 


mode 8, you can also get flash- 
ing as well. All these involve 
quite elementary SuperBasic 
programming techniques, and 
which | won't elaborate on here 


Suggestions 


When you feel confident 
enough to start playing around 
with the assembler listing, here 
are some suggestions. 

This loop could be embedded 
in a larger loop which altered 
one or more of the parameters 
for plottirg the line. In this way 
you could have several lines 
plotted with one CALL of the 

ode. This outer loop could be 

another conditional loop, only 
stoppina when parameters 
reach certain values, or it could 
eat a fixed brie af times. 
In fact a whole series of embed- 
ded loops could be put togeth- 
er, each one involving the 
change of one parameter. This 
is not difficult, provided a couple 
of precautions are taken. First, 
each loop must have a different 
label for its own start and its 
own exit addr Secondly, you 


coc 


must take care about incompati- 
ble branching conditions, which 
may result in the loops never 
starting, or never stopping! 

Instead of letting the lines stop 
at the edge of ‘he screen, you 
could stop them before they get 
there. By using the spare regis- 
ters to hold the row and column 
numbers to stop at you could 
put those values into the com- 
pare instructions. In this case it 
would be a CMP, not a CMPI 
instruction, because you would 
be comparing with a value in a 
register, and not with immediate 
data For example, suppose DO 
held the row you wished to stop 
at. You would use the line 


CMPW DOD2 


followed by either a BPL or a 
BMI, depending on whether this 
was the furthest right or left you 
wish to go. As before | have 
included the code in Marcus 
and Simon's Hex Loader for 
those who do not have an 
assembler. This is Listing three. 

Happy coding! 


TF SERVICES 


MINERVA 


The ULTIMATE operating system upgrade 


MKIN MINERVA with battery for 256 bytes 
CRASHPROOF clock & Philips PC bus for alge 
ck 


‘Other fratures 
DEBLUGGED sy item) reset) 
Mulopie Basic’ faster scheckler-graphics (10% of 
| lighting)-string handling! WHEN BRROR/2nd screery 
TRACE foreign keyboard drivers) "warn" fast reseq! 
AUuto reboot after power failure, 'V1.97 now with built in 
Mutubashc and split OUTPUT baud rates with Hermes. 


st upgrade; free. Otherwise £3 (+ £5 for manual if requd) 
(send sae, roc & NEW disk mds) 
MAKI to MIKI upgrade - £30 


(_ MKI....£40 MKIL.....£65  ) 


BOTH VERSIONS GOLD CARD COMPATIBLE 


QL SPARES 


Faulty QL board (100 phip-ia chips) praia wD 


JM ROM. 
S302 ULA. 
S049 IPC... 


Other compoacnty (sockets etc) please phone 


QL REPAIRS 


Fixed price for unmodified QLs, caching microdrives, 
‘OLs tested with Tham-EMI ny and ROM software 


£27 including 6 month guarantee 


All prices inchode post & packimg (UK only). Payment by Mastercard/Visa/Eurocard/ 
MAIL. ORDER ONLY - no callers without riuging first 


transfer (58 267 3009). 


12 Bouveric Place, LONDON W2 IRB 


Tel: O71-724 9053 


HERMES 


A replacement QL co-processor for 
the QLs awful IPC 8049 
* Do you get keyboard bounce? 


- Do you find fast serial input unreliable? 
* Do you want to compcct a modem at 19200bpa 


If you can say YES to any of these, 
then you need HERMES 


~ 19200bps RELIABLE sezial inpat - NO QCONNECT. 


Finting is simple. Remove the QL wop (8 screws) & 
replace the chip marked $049 or 8749 next to mdy 1. 


£25 including manual/software 


i2C Interfaces 


The PC bus was designed by Philips to simplify 
interfacing. Minerva MKII clock is driven by an [C 
chip, & a connector allows connection of other circuits. 
‘Our extemal circuits will mtcrconncct without Ieads. 


Parallel Interface Up to 4 can be commected powered 
by the OL. Each gives 16 mput/ourput ports. Can be 
uscd wherever Jogi: bevel signals are recpuited - 
oy model train controtlors... ee | 


Anmaloguc interface Up to 4 can be 
comnected & powered off OL, Each gives § maloguc 
to digital inputs, and 2 digitaVanalogue outputs. For 
temp Measurement, sound sampling afc __.... oe 
Data sheets (analogue/paralicl PC chips)... £2 
(Comtrol _softwarc/mannual (Superbasic cxms)_.._£2 


(First imerface purchase inchides free 15D/9D lead) 


ordex/PO Giro 
Ring for overscas prices. 


Vax: O71-706 2379 


eee ith C1. bead (ae Ries I 


wee 


TelepnoraO7saae0a68 = (FEC) =0WV.N. Richardson & Co. 
SINCLAIR OL PRICE LIST Biter so auc 


All Prices Include 17.5% VAT 


| QL Computers] NEW MONITOR £50 CHEAPER 


JS COMPLETB 
a Databaso & Business Gray 


iL. 
QL Computer, PSU, T.V. ee EN ect bens kook , Speeadbent, 3S £120 
membership to QUANTA, the Independant OL User with over 

& HELP. 6 MONTES WARRANTY. WITH bd ROM £100.00 


QL, Programs, & 5 ™ 


” 


QL & PSU only. JS £80 IME6S Pint aeaongh alioacang 15H vapatce) 


—<— essorics | 


k NOTs: RXTERNAL (98RD) $ BUTTON MOUIE AND SOFTWARE hk 
FUNCTIONS. DOM HERMES COs ATGLE 


PC KEYBOARD INTERFACE, INTERNAL FITTING, FOR FITTING 102 KEY KEYBOARD £75.00 

, UK version, 102 key (AT) 2 30.00 
rc JARD INTERFACE and KEYBOARD Shey aah FREE JOYSTICK OR PSU) £ 95.00 
CASE and LBAD for FITTING of Keyboard Interface £ 14.00 


L MOU: 


SE._3 Botton, 5: 


Universal 3.5 lob disk drive, cased with PSU and free QL lead 
‘Universal 3.5° 2Mb disk drive, as above but 2iih capacity 


3.5" ee ee 
4S Oe ee 
Saya tnas arbdiar wabiacal inierca 


mounted, sim 


PHILIPS 14” HIGH RES COLOUR EGA .31 DOT PITCH, FULL 85 COL 
WITH AMBER OR GREEN TEXT FEATURE, IDEAL FOR WORD 
PROCESSING, RECONDITIONED, 90 DAY WARRANTY. 

CE SGR AND Bay a 


‘THE UNIVERSAL DRIVES ARG ALSO SUITABLE POR ACORN BBC, ATARI ST, 
AMIGA, SPECTRUMS, IBM, AMSTRAD AND OTHER PC COMPATIBLES 


£ 70,00 2 Unite for dual drive £120.00 
£98.00 2 Unite for dual drive £170.00 
2 25.00 
49.00 


£10.00 POWER SUPPLY POR UNCASED DRIVES £ 600 
METAL CASES POR UNCASED DRIVES 


(Parallel Printers) “NEW RANGE 


SAMSUNG SPO93 80 Col, 300 ops, 50 NLQ, 3K Print Buffer, Contronice, Tractor Faed/Sheet Peed, Paper Park 
OLIVETTI COLOUR PRINTER, 24 B00 oR. 50 NLA. SE alan, Eagee LEE Compe 
0 


CANNON BJ10 EX 


ay 


(aati Cates ad Spy BARDOT SE 30 


a Cartridges in a wallet & 1000 8 prog carts for pefoematting in 2 wallets eed 
asthe oe new cartridges 
Pack Snag ing Includes Quill, Abacus, Archive, and Easel IN WALLET & 18,00 
‘QL Psion Software  Separais programs € 10,00 
iL power Supply Unit 2 10.00 beaten (end Keeeructlac) & 9.00 
Sv a News ade © 3.00 gous tg? & Bots Case & 5.00 
Ce) = ZX 8301 £ 6.00 zx 8302 £ 3.00 8049 (PC) £ 3.0 MC 1377 & 300 
MC 68008 = £12.00 
Quservicemanuarsecmeur, = eso SALE, FOR FURTHER DETAILS 
i warms: Delivery: 
WO, Access, VISA at cetera Carriage - £9 


SS 7 : 0753 3 888866 FAX: 0753 887149 


DILWYN JONES COMPUTING 


41 BRO EMRYS, TAL-Y-BONT, BANGOR, 


GWYNEDD, LLS7 3YT, GREAT BRITAIN 
TELEPHONE: (0248) 354023 


L SOFTWARE 


A SELECTION FROM OUR RANGE OF NEARLY 100 PRODUCTS FOR THE QL, NO 
ROOM TO ADVERTISE THEM ALL HERE, SO PLEASE ASK FOR OUR 
CATALOGUE (PHONE FOR A COPY OR SEND A LETTER WITH YOUR ADDRESS). 


EASYPTR II] part £40.50 

Simplified pointer environment programming. 
Part I consists of sprite editor, menu editor and 
superbasic extensions to use in your own 
programs. Applications created using Easyptr III 
can be compiled with QLiberator. Requires 
expanded memory, available on disk only. 


EASYPTR IM part2 —-£20.00 
Consists of appendix manager and enhanced 


a a 9 me gH Pron 


Consists of Easysource and C library routines etc. 


QLIBERATOR £50.00 
RY superbasic compiler, compiles virtually all 
of basic plus most toolkit commands, etc. 

duce faster multitasking code from your basic 
programs. Compile resident extensions, use 


overlays etc, with the latest V3.36. Can be mouse 
controlled. Expanded memory required. 


BUDGET QLIBERATOR £25.00 

Excellent value, virtually all of superbasic but 
without some of the additional facilities of the full 
version. Not mouse controlled. Works on 
unexpanded QL too. 


DJTOOLKIT £10.00 

Compact toolkit of BASIC extensions, ideal for 
use with ALiberator. Really useful programming 
commands, can be distributed wit Peigel 
compiled a ifyou wish. At this price, a 
bargain! Suitable for unexpanded QL. 


LINEDESIGN £100.00 

Vector drawing package, uses outline fonts and 
clipart, move and resize text and graphics 
without loss of quality. Ideal for making posters, 
etc. Supplied with huge range of fonts and clipart 
on disks! The more memory your system 
has, the better! Available on disk only, can be 
mouse controlled (including SERmouse). 


DATA DESIGN 3 £60.00 

Superb, fast pointer driven database with free 
form field structures, with the option of disk 
based for large files if required, or smaller files 
can be kept in memory for speed. You do not 
have to be able to program this version but if you 
add the API package, it can be programme 

Jrom basic, é or assembler, Expanded memory 


Pig ey only. 

for Data Design £20.00 

QPAC2 £39.95 

Tony Tebby's superb pointer environment 
aes in addition io the pointer environment 
Jiles themselves, this includes tutorials, extensive 
manual, files menu, channels and jobs menus, 
ee between jobs, hotkeys, etc. Mouse 
or keyboard controlled, a good introduction to 


a environment, 256k ram minimum, disk 
on 


QPACI £19.95 

Ideal companion to QPAC2, consists of small 
accessory programs such as calculator, calendar, 
clocks, alarm clocks, typewriter, etc. All can be 
mouse controlled. Pointer environment files 
included. Can be used with or without QPAC2. 
Expanded memory required, disk only. 


QTYP2 £29.95 
Tony Tebby’s spelling checker program. Check 
spelling as you type OR check existing files 
retrospectively, User interface allows you to write 
programs which use the dictionary facilities. 
Engh French and German dictionaries 
included! 


DISA £29.00 
Interactive pointer driven machine code 
disassembler. 256k ram min. Disk only. 


MEGATOOLKIT £25.00 
EPROM VERSION £40.00 
Large toolkit with over 200 BASIC extensions, 
suitable for use with QLiberator or Turbo. Many 
examples eimys extensive manual. Suitable 
for unexpanded QL. 


DISCOVER £20.00 
The painless way to move files from QL to PC 
and vice versa. As simple as copying files between 
two disks. 256k ram min., disk only. 


MULTI DISCOVER £30.00 

In addition to Discover facilities, also contains 
CPM, Unix CP10, BBC micro and now Spectrum 
and SAM Coupe file transfer capability. 256k 
min, ram, disk only. 


TEXTIDY £15.00 
Assists Discover with conversion of text files by 
stripping out control codes etc, 256k ram min. 


CONVERT-PCX £10.00 
Used with Discover, allows transfer of bit mapped 
PC clipart graphics in PCX format (a common 
PC file ‘bread to QL screens or Page Designer 
pages. 256k ram, disk only. 


QL-PC-FILESERVER £24.50 
Link a PC and a QL via a serial port cable and 
use this sofiware to enable the two to 
communicate - the QL can save its files on a 
PC's disk systems and print to the PC’s serial port 
using normal basic commands like COPY. Works 
on unexpanded QL. 


BANTER £25.00 
Simple to use banner maker which uses outline 
fonts for good quality large texts. Prints sideways 
across up to 4 sheets of paper. Simple to use, 
menu driven, on screen preview before printing, 
etc, Suits most Epson compatible printers. 


IMAGE PROCESSOR 2 £15.00 
Easy to use graphics system, featuring usual 
graphic facilities, pixel zoom editing, image 
titi mode conversion etc. 512k, disk 
only, 


SCREEN COMPRESSION £10.00 
Reduce the amount of storage required by 
graphics on disk or microdrive - supports several 
QL formats. 256k, disk only. 


SCREEN DAZZLER £15.00 
Unlike the usual screen savers, which simply tur 
off the display when the keyboard is not used for 
a while, this one can activate various graphical 
displays to provide an attractive means of 
preventing screen bum-in, more like the screen 
Savers on other computers. If you have a 
compiler, you can even write your own savers by 
following the instructions in the manual. Pointer 
environment compatible. 


SCANNED CLIPART I £10.00 
NEW! A disk full of compressed scanned pictures 
(decompression program supplied of course) 
which can be used in most QL programs (DTP, 
graphics, etc). Assorted collection, containing 
many pictures you may not find in other 
collections, Large number of pictures, a bargain 
at this price. 128k, disk only. 


PRINTERMASTER £20.00 
Select printer control codes quickly and simply 
from a menu to set fonts, page lengths, etc. 
before ero programs like Quill, etc. 
128k, diskim 


SERMOUSE £40.00 
Albin Hessler’s serial mouse driver system for the 
QL is now available from DJC complete with a 
QL style matonne black mouse with 9 pin serial 
connector and UK style port adaptor lead. 
Version 3 driver software. Can now work with The 
Painter too. NB POSTAGE CHARGES BELOW 


MAGAZINES EX-CGH SERVICES 

Ask for a price list of back issues of QL Technical 
Review, QL Leisure Review and QL Adventurer's 
Forum (all available at time of writing). 


SQUIDQY ROUND THE WORLD £12.50 
An arcade game, ideal for the young at heart! 


128k 
5-GAMES PACK £12.50 
5 ‘thinking’ games in one bargain pack, 128k 


PPLIES 


FLOPPY DISKS 
DSHD DISKS 
MICRODRIVES 
DISK LABELS 

On printer roll 
ADDRESS LABELS 
MDV LABELS 
MOUSE MATS 
Disk box dividers 
in stock once more! 


TERMS: Discounts - buy 2 programs, claim 5% off each, buy 3 or more, claim 10% off each program. Offer applies to software only. POSTAGE - Software is sent post free to UK addresses, 
Overseas please add £1.00 per program for postage (maximum £3.00). Floppy disks and serial mouse - add postage of £2.50. Labelsimouse mats - add postage of £0.50 peritem if only buying 
these. PAYMENT - in UK currency (pounds sterling) only please. Payment by cheque, Eurocheque, Postal Order, cash (send by registered post), or by credit card 
(Visa!Mastercard/Eurocard/Connec0. In case of difficulty contact us first to arrange a payment method if none of these is possible for you. Please make cheques, etc payable to DILWYN JONES 
COMPUTING (not to any other name or abbreviation please, our bank prefers it that way). 


